EduOpenAI Core 文档/故障排查
故障排查
常见部署故障与处理
P0：502 Bad Gateway / 服务宕机
- pm2 list 检查 eduopenai 状态与 restarts 计数
- ss -tlnp | grep ":3000" 确认端口监听
- curl -w "HTTP %{http_code}" http://localhost:3000/ 本地直连
- pm2 logs eduopenai --lines 100 --nostream 查崩溃前报错
- 恢复：pm2 restart eduopenai；进程没了按「PM2 与 Nginx」命令拉起 + pm2 save
模型生成失败
| 错误 | 原因 | 处理 |
|---|---|---|
| AllocationQuota.FreeTierOnly | 免费额度耗尽 | 自动回退或手动切换付费模型 |
| invalid api key | API Key 无效 | 检查 .env QWEN_API_KEY |
| fetch failed / ECONNREFUSED | 网络不通 | 查服务器出网、DashScope 可达性 |
| 生成 504 | 超时 | Nginx proxy_read/send_timeout=300s；undici 600s 超时 |
OSS 相关
| 现象 | 原因 | 处理 |
|---|---|---|
| 上传 503 not configured | standalone/.env 未 symlink | ln -s 根 .env 到 standalone/.env + restart |
| 播放 403 | 私有桶资源无签名 | 服务端重签或 Bucket 公共读 + Referer 白名单 |
| 防盗链拒绝 | Referer 不在白名单 | /admin 白名单管理添加域名 |
Hydration 报错
浏览器缓存旧 JS bundle 可能产生 hydration mismatch，清缓存重试即可。