- 学习结果
- 建立上线检查表，知道访问异常时先看 DNS、构建、函数日志还是前端错误。
- 时长
- 2-3 小时
- 难度
- 经验分享
- 核验
- 已核验 2026-10-01 · 下次复核 2026-10-31
正文
发布产物与源码不是同一件事。静态站部署构建输出，服务端项目还需要对应运行适配；先查项目实际命令、输出目录和环境要求。依赖安装、构建和发布各自记录结果，不能把本地开发服务器能打开当作公网部署成功。
环境变量区分公开与机密。浏览器可见的配置不应含数据库管理员密钥、邮件令牌或支付私钥。预览和正式环境分别配置，避免测试发邮件或写入正式数据。更新密钥时考虑轮换与依赖服务，不把.env文件提交进仓库。
域名问题先分层定位。先确认域名是否解析到正确服务，再检查TLS证书、HTTP状态与平台路由。页面能打开但图片404通常是资源路径问题，接口500则应查函数日志；不要每次故障都先修改DNS，盲目改动会扩大影响。
监控围绕用户任务设置。可用性检查关注首页与关键接口，错误日志记录时间、请求标识与错误类型。静态资源、前端脚本和后端函数可能使用不同日志入口。避免把完整个人数据、密码或付款信息记录进日志，告警应指向可执行的排查动作。
备份要证明能恢复。源码进版本管理不等于数据库已备份；数据库、用户上传和配置有不同保存方式。根据能接受的数据丢失量决定周期，保存访问权限与恢复步骤，定期用隔离环境恢复一份样本。只看到备份文件存在不足以证明可用。
回滚分别处理代码与数据。恢复旧部署不一定能撤销数据库迁移，改字段前安排向前与回退兼容。故障时先止住新影响，记录时间线与最后稳定版本，再分析原因。运维清单要包含值守联系方式，而不是只放一个监控仪表盘链接。
学习步骤
- 记录本地启动、构建、预览和部署命令。
- 确认域名、SSL、缓存和重定向。
- 接入访问统计和错误日志。
- 重要数据每天备份，静态内容进 Git。
- 写一份故障排查顺序。
场景拆解
排查上线后的详情页404
模拟情况：首页正常，部分详情页404，构建日志显示路由未生成。域名与证书均可用，排查应聚焦slug、静态路径和输出文件，而不是修改DNS。
- 记录受影响URL与最后正常时间，比较部署版本和构建记录。
- 检查数据slug及路由生成，确认详情产物是否存在。
- 修复后发布预览，检查入口链接和详情；正式回滚前确认数据兼容。
若详情产物未生成，问题在构建输入或路由；若产物存在但平台无法访问，再查平台路由和重定向。不同层的证据能避免把一次404升级成全站域名事故。
补充材料
思维导图、练习、清单和参考资料可按需展开。
01 思维导图和离线文件
适合读完后下载到自己的知识库里继续整理。
从源码到可恢复的线上服务
- 构建：生成部署产物
- 部署：发布版本与记录结果
- DNS / SSL：提供可访问地址
- 日志与告警：发现定位故障
- 备份与回滚：恢复数据或版本
上线与排障的资料
- 启动、构建、预览与部署命令
- 域名、缓存与重定向配置
- 访问统计与错误日志
- 备份位置与回滚方案
故障排查按现象分层
- 域名无法访问 → DNS 与网络
- 部署失败 → 构建与平台日志
- 请求异常 → 函数与服务日志
- 界面异常 → 前端错误
- 数据丢失 → 备份与恢复记录
02 实践练习
根据文章内容记录自己的判断与依据。
排查上线后的详情页404
建立真实发布基线，分层定位详情页404，并在隔离环境恢复样本；代码回滚与数据回退分别评估。
练习场景
模拟情况：首页正常，部分详情页404，构建日志显示路由未生成。域名与证书均可用，排查应聚焦slug、静态路径和输出文件，而不是修改DNS。
准备材料
- 准备部署平台日志权限与一组关键URL。
- 确认正式和测试数据不会混用。
检查点
- 恢复代码后数据库仍是新结构，会发生什么？
练习步骤
01 / 建立发布基线
时间： 20-30 分钟
目标： 让部署步骤可重复
操作：
- 记录实际命令、输出与环境变量位置。
- 检查首页、详情和关键接口。
参考结果： 本地build输出不等于部署已完成。
预期产出： 版本与发布检查单。
检查： 另一台设备可打开关键页面。
02 / 分层排障
时间： 20-30 分钟
目标： 避免无证据地改DNS
操作：
- 记录URL、状态码和时间。
- 按解析、TLS、路由、资源、接口定位。
参考结果： 首页正常但详情404→查路由产物。
预期产出： 故障层与相关日志。
检查： 修复动作与观察到的故障层一致。
03 / 恢复演练
时间： 20-30 分钟
目标： 证明备份可用
操作：
- 在隔离环境恢复数据样本。
- 核对记录和上传资源，评估代码兼容。
参考结果： 旧代码读取新字段前确认迁移兼容性。
预期产出： 恢复记录与回滚限制。
检查： 备份恢复不影响正式用户数据。
完成检查
- 另一台设备可打开关键页面。
- 修复动作与观察到的故障层一致。
- 备份恢复不影响正式用户数据。
03 清单、模板和关键词
用于项目记录和自查。
项目记录
构建命令：____部署记录：____DNS：____SSL：____日志：____备份：____回滚方案：____
发布记录
版本：；依赖安装命令：；构建命令：；输出目录：；运行适配：；环境：预览或正式；密钥来源：；部署URL：；关键页面检查：；最后稳定版本：；代码回滚：；数据库回退限制：。只记录密钥位置，不记录值。
恢复演练单
数据类型：；备份时间：；允许丢失窗口：；保存位置与权限：；恢复环境：；恢复命令：；样本数量与校验：；上传文件是否齐全：；耗时：；未覆盖部分：。隔离演练避免覆盖正式数据或向用户发送测试通知。
关键概念
- 构建命令
- 部署记录
- DNS
- SSL
- 日志
- 备份
- 回滚方案
容易误判
- 将开发预览当正式部署
- 备份存在但从未恢复
- 回滚代码忽略数据迁移