用途
railway-troubleshooting 是一个面向 Railway.com 平台的故障排查技能，用于在部署失败、构建报错、服务崩溃、性能下降或网络异常时，提供系统化的调试与恢复流程。
主要能力
技能以决策树形式组织诊断路径，按问题类型分为五类操作：
- 操作 1：诊断部署失败。检查部署状态、分析部署日志、识别端口绑定、健康检查超时、环境变量缺失、启动命令错误等问题，然后修复并重新部署。
- 操作 2：调试运行时崩溃。收集崩溃信息、识别崩溃模式（立即崩溃、延时崩溃、间歇崩溃、退出码 137 即内存不足）、检查资源限制，处理内存泄漏、依赖缺失、未捕获异常、外部服务不可用等情况。
- 操作 3：排查网络问题。验证服务发现（内部域名格式为 [service-name].[project-name].railway.internal）、检查私有网络配置、调试外部访问、处理 DNS 解析失败、SSL 证书错误、端口不匹配和超时。
- 操作 4：修复构建错误。检查构建日志（区分检测、安装、构建阶段）、验证构建器配置（nixpacks.toml 或 railway.toml）、修复依赖问题、必要时强制重建（清除缓存）。
- 操作 5：解决数据库问题。验证数据库连接、检查连接配置、调试连接拒绝/超时/认证失败/连接数过多、进行性能排查，并提供应急恢复流程（重启服务、检查备份、纵向扩容、处理连接泄漏）。
使用方式
技能提供决策树引导，并配套命令行示例：使用 railway status 查看状态，railway logs --deployment 查看部署日志，railway logs --tail 500 获取运行时日志，railway metrics 查看指标，railway logs --build 查看构建日志，railway up --detach 触发部署，railway restart [service-id] 重启服务，railway run 执行命令如 nslookup 或 psql 测试连接。此外提供诊断脚本 ./scripts/diagnose.sh [service-id] --verbose 用于自动检测问题，以及 ./scripts/force-rebuild.sh [service-id] --no-cache 用于清除缓存并重建。诊断脚本会检查服务健康状态、分析近期部署日志、扫描常见错误模式、检查资源利用情况并给出建议。
适用场景
当遇到部署失败或构建错误、服务重启循环或崩溃、网络或连接问题、运行时错误或性能问题、数据库连接或查询问题、性能下降、配置或环境问题时，可使用此技能。
限制
具体收费、价格、平台支持范围及效果未提供。技能内提到的错误指南、调试工作流、恢复流程、诊断脚本等引用文档，其详细内容未在资料中完整给出。使用需依赖 Railway 平台及相应 CLI/API 环境。