What is the problem?
新手遇到 GitHub Actions build 失败时，不要只看红叉。本文按 workflow、job、step、关键错误、环境变量、权限和本地复现拆解日志排查流程，帮助你判断下一步该修代码还是请客户补授权。
Quick solution
Treat this as a GitHub tutorial issue. First confirm the environment, inputs, permissions, logs, and delivery boundary. Then use the linked deep guide for the full checklist before changing production code or promising a result.
Read the deep guideDetailed steps
- 依赖安装失败。
- lint 或 test 失败。
- build 命令失败。
- 环境变量缺失。
- 权限或 secret 不存在。
- 部署平台返回错误。
Commands or code
Workflow:
Job:
Step:
Command:
First error line:
Last error line:Risk notes
Confirm the real project environment, account permissions, platform rules, and output quality before delivery. Do not ship AI-generated changes without human review, and do not claim indexing, income, deployment success, or ranking improvements without measured evidence.