故障排查
登录问题
| 现象 | 处理方式 |
|---|---|
| 登录请求无效或已过期 | 返回 /login 重新发起钉钉授权。state 只能使用一次。 |
| 仅允许公司内部账号登录 | 确认当前钉钉账号属于系统配置的企业。 |
| 无法建立登录会话 | 检查 Redis 可用性后重新登录。 |
API 错误
| HTTP 状态 | 含义与处理 |
|---|---|
401 |
API Key 缺失、格式错误、已禁用或已过期。 |
403 |
用户已停用。 |
429 |
超过 RPM 或最大并发限制；等待请求完成或下一时间窗口。 |
502 / 503 |
上游暂时不可用；使用请求 ID 查询请求日志。 |
管理员检查项
- 在模型中心确认 Codex 模型状态为启用。
- 确认模型至少绑定一个健康、启用的上游端点。
- 检查用户与 API Key 的
rpm_limit和max_concurrency。 - 使用请求 ID 在请求日志中查看上游尝试、状态码和耗时。