全栈应用服务器 > 使用指南 > 一键部署 > 故障排查

故障排查

最近更新时间: 2026-09-03 15:55:07

打开一键部署详情页，选择失败的 Revision 并查看日志。根据失败阶段进行排查。

按阶段排查

阶段	常见原因	处理建议
`resolving`	branch 或 Tag 不存在，仓库不再公开。	检查仓库 URL、仓库公开状态和引用名称，然后重新创建部署。
`preparing`	Sandbox 区域、模板不可用或账户配额不足。	选择页面中可用的区域或模板，并检查 Sandbox 配额。
`cloning`	固定 Commit 无法拉取。	确认仓库仍然公开，重新读取仓库快照后再部署。
`installing`	依赖文件缺失、安装命令退出失败或安装时间过长。	在干净的 Linux 环境中复现安装命令，确认依赖文件已提交。
`starting`	启动命令退出、端口不一致或只监听本地地址。	确认命令以前台方式运行，并监听 `0.0.0.0:<port>`。
`probing`	健康检查路径不存在、返回失败状态或服务启动较慢。	使用无需登录的健康检查路径，并确认它返回成功 HTTP 状态。
`cleaning`	Sandbox 仍在停止或清理。	保持等待并刷新详情页，直到进入最终状态。

一键部署当前只支持公开 GitHub 仓库。私有仓库、被删除的仓库和无法访问的仓库不会被区分展示，避免泄露仓库存在性。确认仓库可以在未登录 GitHub 的浏览器窗口中访问。

Revision 使用固定的 Commit 和配置摘要。修改 .qiniu/deploy.yaml 后，需要重新创建部署，或在终止态 Deployment 上重新部署；已有 Revision 不会自动改变。

创建、停止、删除和重新部署都包含后台资源操作。先查看当前 Revision 日志和状态，不要连续创建多个 Deployment。若网络请求超时，回到原 Deployment 详情页刷新即可。

提交问题时请提供 Deployment ID、Revision ID、失败阶段、错误提示和发生时间。页面或接口响应中的 Request ID 也应一并提供。请勿提交 API Secret、GitHub Token、完整请求签名或仓库配置原文。

以上内容是否对您有帮助？