维护模式
在系统 → 配置(Config)的「维护模式」分区设置维护时间与提示,旧的维护模式地址会自动跳转到这里。适合迁移、切换或维护窗口;它不会自动为你执行数据库迁移。
开启后的行为
Section titled “开启后的行为”| 对象 | 行为 |
|---|---|
| 新的模型、工具、MCP 和实时连接请求 | 返回 503,带维护标识与重试提示;拒绝发生在鉴权之前,不写请求日志、不扣费、不占 RPM |
| 健康检查和模型、额度、目录等只读入口 | 继续可用;/health 仍返回 200,并带维护状态 |
| 已开始的流式请求 | 继续运行,结束后按原规则记账 |
| 管理端写入 | 可选冻结,默认开启;维护开关等必要例外仍可操作 |

维护窗口步骤
Section titled “维护窗口步骤”- 设置预计时长(须为正整分钟)和中英文提示,确认是否同时冻结管理写入;开启前可预览客户端看到的提示。预计时长只用于提示,到时不会自动结束维护。
- 开启后确认后台维护横幅及新请求的响应;各进程配置缓存会带来短暂生效延迟。维护中可在同一分区查看预计恢复时间,并延长或结束维护。
- 等待在途调用完成,再按目标版本参考执行迁移或切换。
- 维护结束后在实际承接流量的新环境关闭维护,并发送一条真实请求。
配置读取失败时采用放行行为;维护模式不能替代数据库或网络层的强制隔离。跨数据库迁移可能复制维护配置,切换后需要明确检查。
完整例外接口、权限与运行语义见 维护模式参考。