已知限制与版本策略

部署、升级或切换生产流量前，一次确认 2.0 的运行边界、兼容性和版本通道。

部署与数据§

只支持单实例

2.0 只保证单个应用实例的正确性。调度、冷却、限流与亲和等状态不会在实例之间共享；换用外部数据库也不会获得横向扩展能力。

需要隔离业务或扩大容量时，按业务维度拆成多个独立部署，不要在同一套配置前直接增加负载均衡实例。

1.x 不能原地升级

2.0 不能打开、导入或转换 1.x 的数据。两套版本必须使用不同的数据库、数据目录、端口与 Docker 卷。

正确方式是并行部署 2.0，重新配置并验证，再切换流量；回滚窗口结束前保留原来的 1.x 实例。

不自动跨数据库驱动搬迁数据

版本升级需要的 Schema 迁移会在启动时自动执行；但在 SQLite、MySQL 与 PostgreSQL 之间切换时，GPT-Load 不会复制原有配置和数据。

换驱动时请使用新数据库重新配置、验证并切流量。不要把它和自动 Schema 迁移混为一谈。

成本是估算，不是账单

成本根据上游返回的 token 用量和模型价格计算。缺少用量或价格的请求不能完整计价，价格变化也不会回算历史。

这些数据适合运营分析与异常保护，不适合财务对账。

成本限制是软保护

网关在请求完成后才把本次估算成本计入额度。单次大请求和已经放行的并发请求可能让累计金额超过阈值；未定价或缺少用量的请求也不会计入。

需要严格预算时，还应使用服务商提供的账单告警、预算或硬额度。

不提供资源到凭据的强绑定

previous_response_id、conversation 和其他资源 ID 通常依赖创建资源的上游凭据。当前亲和机制不读取这些 ID，不能保证后续请求回到原凭据。

可靠使用有状态资源时，让分组只保留一个凭据，或确认上游允许不同凭据共享同一资源。

不支持 ENCRYPTION_KEY 轮换

更换或丢失 ENCRYPTION_KEY 后，已有渠道凭据无法解密。当前没有使用新旧两把主密钥重加密现有数据的流程。

数据库与加密密钥必须成套备份；恢复时先使用与备份匹配的程序版本和密钥。

标签	含义	适用场景
2.0.0-rc.2	精确版本标签，不带 Git tag 的 v 前缀	需要固定版本时使用；生产环境也可以固定镜像摘要
2	2.x 浮动通道；GA 前可跟随已验证的 2.0 Beta 与 RC，GA 后只跟随稳定 2.x	接受经过发布门禁的新版本时使用
2.0-beta	只跟随格式严格的 2.0 Beta，不跟随 RC	只想停留在 Beta 通道时使用
2.0-rc	不存在这个浮动标签；RC 使用精确标签，GA 前也可能推进 2	不要配置
latest	继续保留在 1.x，不代表 2.x	部署 2.x 时不要使用

数据库迁移是单向的。回滚不能只改镜像标签，还要恢复升级前的数据库和配套密钥。