Web 服务部署流程

解决的问题

这个技能针对「源码已能本地跑，但公网部署后白屏、接口空数组、缓存旧页面」这类上线故障。它把 Web 服务从服务器环境检查、DNS 解析、Nginx 配置、CDN 回源、前端构建到冒烟测试，压缩成可重复执行的检查单，适合 React/Vite 前端与 Express BFF 后端组合。

如何工作

核心不是单纯上传文件，而是按顺序验证链路：

• 环境与网络：检查 SSH、tccli、域名权限、Node 版本，确认 dig 解析可用。
• 入口与回源：配置 Nginx 静态路径和 API 转发；启用 EdgeOne 时重点设置 OriginProtocol，若 Nginx 只监听 80，避免 HTTPS 回源导致旧内容或错误页。
• 构建与字段映射：前端 build 后清理 CDN 缓存；后端统一处理腾讯云 TEO 等 SDK 与文档不一致的字段名、嵌套结构、分页参数和时间格式。
• 验证：用 Playwright 对页面和 API 做冒烟测试，再同步仓库并清理临时状态。

边界与注意

该流程偏腾讯云轻量/CVM、DNSPod/EdgeOne 场景，需要 root SSH、域名管理权限和 Node.js >= 22。它不能替代安全审计或复杂高可用设计；若 Nginx 未开启 443，CDN 回源协议要谨慎；前端白屏常见根因包括残留 CSS、不存在图标、JS hash 不匹配和 CDN 缓存。