运维、升级与故障排查
运维基线
- 监控容器、HTTP 5xx、SSE 首字延迟、模型/能力错误率、数据库连接池和磁盘。
- 日志不得出现完整模型 Key、OAuth Secret、银行卡号、发票原文和下载凭据。
- 备份 AgentOS 独立库和私密配置；Redis 缓存不作为唯一数据源。源码交付模式不需要技术授权书。
- 升级前备份并在预发布验证；前端、后端、SQL 使用同一版本，禁止跳版本或修改已发布 SQL。
常见故障
| 现象 | 处理 |
|---|---|
| SSO 循环/两次授权 | 核对 /ai/sso-callback、自动授权范围和 X-Forwarded-Proto |
| 对话无流式输出 | 确认 /admin-api/agentos/ 路由优先，关闭 Nginx SSE 缓冲 |
| 模型 401 | 在模型服务页面核对地址、Key、租户状态，不打印密钥 |
| OCR 失败 | 检查白名单、Token、清晰度、单页单票和金额一致性 |
| Finance 技能不可用 | 先核对 RuoYi Office 平台事务接口、来源幂等字段和唯一索引版本 |
| 数据库/Redis 失败 | 检查内网 DNS、最小权限账号和独立 Redis database |
回滚优先切回上一版本镜像；若版本含不兼容数据库变化，使用该版本回滚脚本或恢复升级前备份，禁止手工删字段。
