使用act本地测试GitHub Pages部署时遇ACTIONS_RUNTIME_TOKEN错误

1. 传入ACTIONS_RUNTIME_TOKEN仍报错的原因及解决办法 #

actions/upload-pages-artifact是GitHub官方专为GitHub Actions环境开发的动作，它依赖的ACTIONS_RUNTIME_TOKEN是GitHub内部生成的、与当前工作流会话绑定的专属有效令牌，并非随便填写一个字符串就能通过验证。本地用act模拟时，无法复现GitHub的令牌生成与验证机制，所以哪怕手动传入该变量，也会触发报错。

解决思路： #

• 如果只是测试前端构建流程，不需要真的上传Pages artifact，可以临时注释掉Upload artifact和Deploy to GitHub Pages这两个步骤，只验证依赖安装、构建等环节是否正常。
• 若要测试artifact上传逻辑，改用通用的actions/upload-artifact动作替代actions/upload-pages-artifact，这个通用动作在act环境下可以正常工作，示例修改如下：

# 替换原Upload artifact步骤
- name: Upload test artifact
  uses: actions/upload-artifact@v4
  with:
    name: frontend-build
    path: './frontend/build'

2. 调试信息的含义解析 #

• ::debug::Root artifact directory is /tmp：upload-pages-artifact动作在系统临时目录/tmp下生成了打包后的artifact文件（比如artifact.tar），用于后续上传。
• Artifact name is valid!：动作自动使用的Pages artifact默认名称（github-pages）符合GitHub的命名规则，没有非法字符或长度问题。
• Root directory input is valid!：你指定的上传路径./frontend/build已被动作识别为有效目录，目录存在且可访问，动作已准备好将该目录下的内容打包。

内容的提问来源于stack exchange，提问作者Gulzar