模型回滚流程：版本能切回去，数据也要对得上

2026/7/5 13:12:50

模型回滚流程：版本能切回去，数据也要对得上

一、模型回滚不只是把镜像换回旧版本

模型上线后发现效果退化，常见反应是回滚镜像。但 AI 服务的版本不只在镜像里。模型权重、tokenizer、prompt 模板、后处理逻辑、向量索引和评测阈值都可能参与结果。只回滚容器镜像，未必能恢复到旧行为。

因此模型回滚需要一套版本清单。每次发布要记录运行镜像、模型文件摘要、配置版本、依赖数据版本和流量策略。回滚时按清单恢复，而不是靠人临时回忆。

二、把模型发布对象做成不可变快照

平台可以把一次模型发布抽象为 Release。Release 包含所有影响结果的组件引用。线上服务只引用 Release ID，回滚就是把流量切回旧 Release。

flowchart TD A[模型权重] --> E[Release 快照] B[Tokenizer] --> E C[Prompt 模板] --> E D[后处理配置] --> E E --> F[灰度流量] F --> G{指标异常} G -->|是| H[切回旧 Release] G -->|否| I[扩大流量]

Release 一旦发布就不应被修改。需要修复时创建新 Release。这样审计和回滚才不会混乱。

三、控制面要拒绝不完整的发布

下面示例展示一个发布校验函数。它要求关键组件都有摘要，避免“引用了一个路径但不知道内容是什么”。

type ModelRelease struct { ID string ImageDigest string ModelDigest string PromptVersion string ConfigChecksum string } func ValidateRelease(r ModelRelease) error { if r.ID == "" || r.ImageDigest == "" || r.ModelDigest == "" { return fmt.Errorf("release missing immutable identity") } if !strings.HasPrefix(r.ImageDigest, "sha256:") { return fmt.Errorf("image digest must be immutable") } if r.PromptVersion == "" || r.ConfigChecksum == "" { return fmt.Errorf("release missing prompt or config version") } return nil }

这里强制使用 digest，而不是 tag。镜像 tag 可以移动，digest 才能保证回滚时拿到同一份产物。