会话恢复与联调模式
这页解决什么问题
LuckyColor 前端有两个特别容易让接手者误解的点：
- 登录后到底是靠哪个接口把页面跑起来
Spring Boot / NestJS两种联调模式到底怎么切换
这页专门把这两块说明白。
先说真实会话链路
登录成功时发生了什么
当前前端登录成功后的真实链路不是“只调一次 /api/auth/access 就完成初始化”，而是更接近下面这个流程：
当前前端实际怎么做
登录页完成的事情主要有：
- 调用
/api/auth/login - 保存
accessToken - 保存当前用户基础资料
- 保存当前租户上下文
- 再调用
/api/menus/tree - 用菜单树初始化动态路由
所以如果你在联调时发现“登录成功但没菜单”，优先不要只盯 /api/auth/access，而要先看：
/api/auth/login/api/menus/tree
页面刷新后是怎么恢复状态的
登录后刷新页面，前端走的是另一条链路。
为什么要拆成 profile + menuTree
这套设计的好处是：
- 用户资料恢复更轻量
- 菜单树可以单独缓存
- 页面刷新时不一定每次都重新走完整权限快照接口
/api/auth/access 现在是什么角色
/api/auth/access 依然是有效接口，而且它返回的内容更完整，一般包含：
- 当前用户基础资料
- 角色列表
- 菜单树
- 菜单权限码
- 按钮权限码
所以它更像：
- 后端统一访问快照接口
- 调试权限问题时很有价值
- 安全和联调时的权威接口
但“当前前端默认初始化流程”并不是完全依赖它。
这三个接口怎么分工最容易理解
| 接口 | 适合拿来做什么 | 当前前端是否直接依赖 |
|---|---|---|
/api/auth/login | 登录并拿到 token 与用户快照 | 是 |
/api/auth/profile | 刷新页面后恢复当前用户资料 | 是 |
/api/menus/tree | 初始化或恢复菜单树与动态路由 | 是 |
/api/auth/access | 查看完整访问快照、调试权限与联调 | 有，但不是唯一初始化入口 |
常见误区
误区 1：登录成功后菜单一定来自 /api/auth/access
当前前端实际不是这样。默认链路更偏向“登录拿用户，菜单单独拉树”。
误区 2：刷新页面后一定重新走完整登录链路
不是。刷新后的恢复重点是：
- token 仍然有效
- 用户资料可恢复
- 菜单缓存可恢复
误区 3：按钮权限只看前端控制
不是。前端只是显隐，最终还是以后端权限判断为准。
再说联调模式
LuckyColor 前端当前重点维护的是两种真实后端联调模式：
- Spring Boot 模式
- NestJS 模式
1. Spring Boot 模式
启动命令：
powershell
pnpm dev或：
powershell
pnpm dev:springboot特点：
- 通过 Vite 代理把
/api转到http://127.0.0.1:3001 - 对应当前默认本地联调方案
- 最适合验证 Java 版本接口契约是否满足前端要求
适合场景：
- 联调 Spring Boot 后端
- 排查 Java 版本的权限和租户问题
- 交付前验证默认联调链路
2. NestJS 模式
启动命令：
powershell
pnpm dev:nestjs特点：
- 通过 Vite 代理把
/api转到http://127.0.0.1:3002 - 更适合对照原始 Node.js 实现
- 便于验证 Spring Boot 与 NestJS 之间的接口契约差异
适合场景：
- 联调 NestJS 后端
- 回看历史实现与目录边界
- 对照两套后端的行为是否一致
两种模式怎么选
| 目标 | 推荐模式 |
|---|---|
| 默认联调、Java 交付链路验证 | pnpm dev 或 pnpm dev:springboot |
| 对照 Node.js 旧实现与兼容性验证 | pnpm dev:nestjs |
本地排查时最有用的判断思路
登录成功但菜单没出来
优先检查：
/api/auth/login是否返回了正常用户快照/api/menus/tree是否返回菜单树- 当前租户 Header 是否正确
- 菜单
component是否能映射到真实页面
刷新后白屏或路由丢失
优先检查：
- 本地 token 是否还在
/api/auth/profile是否成功- 菜单缓存是否存在
- 动态路由是否已重新注册
- Nginx 是否配置了 SPA 回退
Spring Boot 能跑，NestJS 模式报错
优先检查：
- NestJS 是否已改到
3002 pnpm dev:nestjs是否真的加载了.env.nestjs- Spring Boot 与 NestJS 是否存在字段名或路径差异
- 页面是否依赖了只在某一套后端实现里存在的兼容字段