前端发布最怕“构建通过就上线”。构建通过只说明代码能被打包,不代表页面能打开、接口能通、资源路径正确、环境变量没错。真正的发布检查应该覆盖构建前、构建后、部署后和回滚准备。

一、构建前确认范围

发布前先确认这次改动影响哪些页面、接口、权限和配置。纯样式改动和认证链路改动风险完全不同,检查强度也应该不同。涉及登录、支付、提交、删除、权限、路由守卫的改动,一定要扩大验证范围。

二、构建后确认产物

产物检查包括环境变量、资源引用、入口 HTML、关键域名和构建目录。尤其是多环境项目,要确认灰度产物不会连生产 API,生产产物不会引用测试地址。这个检查最好脚本化,不能靠肉眼临时看。

发布不是把文件传上去,而是让当前版本可确认、可访问、可回退。

三、部署后立刻走核心链路

部署完成后,不要只看首页。要按影响范围走最小核心链路,例如登录、打开关键页面、提交一次低风险操作、刷新页面确认状态仍然正确。发现问题时要优先恢复用户可用性,再继续排查根因。

  • 发布前列出影响页面和高风险流程。
  • 构建后检查环境变量和资源路径。
  • 部署后验证首页、关键页面和核心操作。
  • 上线前准备清楚回滚方式和旧版本位置。

发布检查会花时间,但比线上事故后的补救便宜得多。越是小团队,越需要把检查清单固定下来。