troubleshooting-basics

# 基础故障排查（部署时和启动时） 当部署失败、服务启动时崩溃或健康检查超时时使用此指南。 保持修复最小化，并在每次更改后重新部署。 ## 1) 对故障进行分类 - **构建失败**: 构建日志中的错误、缺少依赖项、构建命令问题。 - **启动失败**: 应用快速退出、崩溃或无法绑定到 `$PORT`。 - **运行时/健康检查失败**: 服务已上线但健康检查失败或出现 5xx 错误。 ## 2) 按类别快速检查 **构建失败** - 确认构建命令对于该运行时是正确的。 - 确保 `package.json`, `requirements.txt` 等中存在所需的依赖项。 - 检查是否缺少构建时的环境变量。 **启动失败** - 确认启动命令和工作目录。 - 确保端口绑定为 `0.0.0.0:$PORT`。 - 检查是否缺少运行时的环境变量（密钥、数据库 URL）。 **运行时/健康检查失败** - 验证健康检查端点的路径和响应。 - 确认应用确实在监听 `$PORT`。 - 检查数据库连接和迁移。 ## 3) 将错误特征映射到修复方案 使用 [error-patterns.md](error-patterns.md) 获取常见日志消息的精简目录。 ## 4) 如果仍然受阻 收集最新的构建日志和运行时错误日志，然后考虑使用可选的 `render-debug` 工具进行更深入的诊断（指标、数据库检查、扩展模式）。