· Zcode Team · 工程交付 · 约 3 分钟阅读
一次可靠发布需要检查什么？
从变更范围、数据库迁移到发布后验证，整理一份可执行的上线检查清单。
“构建成功”只说明产物生成了，并不等于用户可以正常使用。发布是一个跨越代码、配置、数据和运行环境的过程。把这些环节写成清单，能减少靠记忆操作带来的遗漏。
发布前：确认变更边界
先看本次提交到底改了什么。依赖版本、环境变量、数据库结构、静态资源路径和反向代理规则，都会影响发布方式。特别是数据库迁移，需要明确它能否在新旧版本同时运行的短暂窗口内保持兼容。
检查项可以从以下问题开始：
- 新版本是否依赖尚未执行的迁移？
- 新旧版本同时运行时，读写的数据结构是否兼容？
- 新增配置是否已在目标环境提供？
- 前端资源 URL、缓存策略与路由回退是否匹配？
- 回滚时，旧版本能否读取新版本写入的数据？
发布中：观察系统，而不是只看流水线
流水线状态、容器健康检查和用户请求是三种不同的信号。健康检查通过后，还应使用真实域名访问关键页面和接口，观察错误率与延迟是否变化。对于异步任务，要验证提交、处理和结果获取三个阶段。
如果发布需要流量切换，先准备可回退的旧版本，再做切换。记录新旧版本的镜像、配置和数据库迁移编号，遇到问题时才能准确定位。
发布后：用用户路径验收
选择少量最重要的业务流程进行冒烟验证：登录、列表加载、详情查看、关键提交或下载。发现问题时，先判断它属于代码、数据、配置还是外部依赖，再决定修复还是回滚。
一份好的发布清单不需要很长，但应该能回答三个问题：发布了什么、当前是否正常、出问题如何恢复。