部署后排查问题
记下访问 URL、发生时间、操作步骤、浏览器、错误截图、请求 ID 和最近一次发布版本。不要只说“网站打不开”；可复现信息能明显缩短排查时间。
1. DNS 和网络
Section titled “1. DNS 和网络”确认域名是否解析到正确目标、DNS 是否还在缓存、服务器端口是否开放。可以先访问平台提供的默认域名，区分“应用问题”和“域名问题”。
2. HTTPS
Section titled “2. HTTPS”检查证书域名、有效期、证书链和 HTTP 到 HTTPS 的跳转。混合内容（HTTPS 页面加载 HTTP 资源）也会被浏览器阻止。
3. 构建和启动
Section titled “3. 构建和启动”查看完整构建日志，确认生产命令、工作目录、运行时版本和端口配置。平台通常会把“监听错误端口”或“进程启动后立即退出”记录在部署日志里。
4. 环境变量和第三方服务
Section titled “4. 环境变量和第三方服务”核对变量名、环境范围和是否需要重新部署；确认 Key 未过期、有余额、权限和正确的 Base URL。不要把完整密钥复制到聊天或工单中。
5. 应用逻辑和数据库
Section titled “5. 应用逻辑和数据库”结合浏览器 Network、服务端日志和数据库状态定位。检查迁移是否执行、时区是否一致、超时和重试是否合理。
| 状态 | 常见含义 | 先看什么 |
|---|---|---|
| 400 | 请求格式或参数错误 | 请求体、必填字段 |
| 401 | 未认证或 Key 无效 | 登录、Token、环境变量 |
| 403 | 无权限或被策略拒绝 | 角色、域名、网络策略 |
| 404 | 路径、部署或资源不存在 | URL、路由、发布版本 |
| 429 | 频率、额度或并发限制 | 服务商额度、重试策略 |
| 500 | 服务端异常 | 应用日志和最近改动 |
| 502/503 | 上游或服务暂不可用 | 启动状态、代理、第三方状态 |
如果影响持续扩大，先回到上一个已知可用版本，再慢慢定位。数据迁移和不可逆操作要单独评估，代码回滚不一定能自动回滚数据。
让 AI 协助排错
Section titled “让 AI 协助排错”提供脱敏后的日志、时间、版本、命令和期望结果，让它先提出排查顺序，不要直接执行清空数据、重装系统或修改生产权限的命令。每完成一步就记录结果。