Troubleshooting

现象	先查
前端白屏	是否用了 `:3001`？改 3100；清 SW / 缓存
API 连不上	后端是否在 `:8000`；CORS / `NEXT_PUBLIC_API_BASE_URL`
Render 超时	冷启动；先 `GET /health`
real 模式无反应	`NEXT_PUBLIC_DEMO_MODE` 与后端是否同为可联调状态
CAW real 失败	env 是否齐全；是否 fail-closed（预期）；见 CAW 文档
Agent 聊天 5xx	后端是否配置 `MINIMAX_API_KEY`（勿提交进 git）
README 预览空白 / 断连	4173 上的 `python -m http.server` 是否僵死；重启并 `--bind 127.0.0.1`
Bob 居然能付	Demo 数据被改坏；对照 Demo-Data-and-Guardrails

Navigation Menu