针对我遇到的 GitHub Actions 部署失败问题(红色叉标记),以下是详细排查和解决方案:
我们注意到在验证步骤中,GitHub Actions 运行失败了(红色叉)。我们需要检查失败原因并修正工作流配置。
根据经验,常见原因有:
- 构建步骤错误(比如缺少依赖)
- 使用的 Actions 版本过时或配置错误
- 权限问题(GITHUB_TOKEN 是否有推送权限?)
由于我们的示例是纯静态站点(无需构建),所以构建步骤很简单,只是复制文件。但失败可能是因为我们使用的 peaceiris/actions-gh-pages@v3 要求目标目录必须存在且非空。
另外,我们创建了一个空分支 gh-pages,但第一次运行时,该分支可能还没有内容,所以部署步骤可能会失败。
让我们调整工作流:
4. 确保在部署前生成内容:即使只是纯静态文件,我们也需要将文件复制到一个目录(如 public),并且该目录必须有内容(比如至少有一个 index.html)。
5. 使用正确的目录:在 Copy files 步骤中,我们创建了 public 目录并复制所有文件。但要注意,复制时可能会忽略以.开头的文件(比如 .gitignore),不过对于部署来说,这些文件通常不需要。
6. 检查 peaceiris/actions-gh-pages
订阅专栏 解锁全文

被折叠的 条评论
为什么被折叠?



