故障排查

登录问题

现象	处理方式
登录请求无效或已过期	返回 `/login` 重新发起钉钉授权。state 只能使用一次。
仅允许公司内部账号登录	确认当前钉钉账号属于系统配置的企业。
邮箱或密码不正确	账号密码登录只对管理员建过号的邮箱有效；钉钉账号没有密码。忘记密码找管理员在用户详情页重置。
登录失败次数过多	同一账号 15 分钟内失败 8 次会被暂时拒绝，等窗口过去再试或找管理员重置密码。
无法建立登录会话	检查 Redis 可用性后重新登录。

HTTP 状态	含义与处理
`401`	API Key 缺失、格式错误、已禁用或已过期。
`403`	用户已停用。
`429`	超过 RPM 或最大并发限制；等待请求完成或下一时间窗口。
`502` / `503`	上游暂时不可用；使用请求 ID 查询请求日志。