Codex修改登录权限总出问题的排查与解决方案

摘要

登录成功却反复跳回登录页，刷新后权限丢失，普通用户突然看到管理员菜单——这些场景在前端项目中实在太常见了。这类故障往往不是单点问题，而是整个认证链路中的某个环节出了岔子。Token 怎么存的、用户状态怎么恢复的、路由守卫在什么时机触发、接口权限怎么配合的，全都有关系。这篇文章要聊的是，怎么让 Codex 先把整个认证链路捋清楚，再动手修，修完后还要验证到位。

不少开发者遇到登录异常，第一反应就是让 Codex 去改登录页面：

登录后总是跳回登录页，帮我修复。 

但说实话，问题往往不在登录按钮本身，而是出在登录成功后的状态恢复流程上。

一套典型的认证链路是这样的：

提交账号密码
→ 接口返回 Token
→ 保存 Token
→ 获取用户信息
→ 写入状态管理
→ 路由守卫判断权限
→ 加载对应菜单

这里面任何一个环节处理不完整，都可能跳出登录异常或权限错乱。

一、先让 Codex 分析调用链

可以先输入这样的指令：

请分析当前项目的登录和权限流程，不要修改代码。
重点检查：
1. 登录接口；
2. Token 保存与读取；
3. 用户信息初始化；
4. 路由守卫；
5. 菜单权限；
6. 接口 401 处理；
7. 退出登录流程；
8. 相关测试文件。

目标是先确认问题到底发生在哪一层，然后再决定修改范围，而不是上来就改。

二、重点排查三个常见问题

1. 刷新后状态丢失

状态管理通常保存在内存中，浏览器刷新后会被清空。如果项目只保存了 Token，却没有在刷新后重新请求用户信息，路由守卫就可能把已登录用户当作未登录处理。

2. 权限判断执行过早

用户信息还没恢复完，路由守卫就已经开始判断角色了，这也会导致错误跳转。可以增加一个明确的初始化状态来避免这种情况：

type AuthStatus =
  | "idle"
  | "loading"
  | "authenticated"
  | "unauthenticated";

只有初始化完成后，才允许执行权限判断。

3. 前端隐藏菜单不等于权限控制

前端不显示管理员按钮，不代表接口就安全了。真正的权限校验必须由后端来完成。Codex 可以帮助整理前端展示逻辑，但绝不能通过修改菜单配置来替代后端鉴权。

三、严格限制修改边界

登录和权限属于高风险模块，必须明确哪些能改，哪些不能动：

允许修改：
- src/stores/user.ts
- src/router/guard.ts
- tests/auth
禁止修改：
- 后端权限规则；
- Token 签名逻辑；
- 数据库用户角色；
- package.json；
- 其他业务模块。

如果问题只是刷新后用户状态未恢复，那就别顺手重构整个权限系统。

四、必须补充回归测试

至少需要覆盖以下场景：

• 登录成功后能正常进入首页；
• 刷新页面后保持登录状态；
• Token 失效后自动跳回登录页；
• 普通用户无法进入管理页面；
• 管理员菜单正常显示；
• 退出后本地状态被清空；
• 用户信息接口失败时，系统不能继续进入。

修改完成后运行：

npm run type-check
npm run test
npm run build

最后检查 Git Diff，确认没有误删权限判断，也没有降低测试标准。

五、什么时候需要考虑升级 Pro？

偶尔排查一个登录问题，现有方案通常够用。

但如果每天都需要让 Codex：

• 阅读前后端认证代码；
• 分析多个权限模块；
• 连续修改和运行测试；
• 处理大量接口日志；
• 同时维护多个项目；
• 反复检查安全风险；

那就说明 Codex 已经进入了持续工程开发流程。

这种情况下，应该先通过任务拆分和 AGENTS.md 控制范围。如果工作流已经优化，但长上下文分析、测试和多文件修改还是频繁中断，那就可以重新评估 Plus、Credits 与 Pro。对于长期高频开发者，Pro 更容易保持任务连续性，减少反复恢复上下文的时间。

总结

用 Codex 修改登录权限问题时，不能只盯着登录页面。

更稳妥的流程是：

先梳理认证链路，再定位失败阶段；先限制修改范围，再补充测试；最后检查 Git Diff 和真实的权限结果。

登录和权限模块关系到账户与数据安全，AI 可以帮助定位问题，但最终规则仍然需要开发者和后端共同确认。