GitHub Actions部署GitHub Pages报错：环境URL无效及工件未找到

核心错误：找不到名为github-pages的Artifact #

你更新后的工作流把actions/upload-pages-artifact@v1换成了通用的actions/upload-artifact@v4.0.0，但没指定Artifact名称。actions/deploy-pages默认会查找名为github-pages的Artifact，这就是报错的根本原因。

修复方法 #

在Upload artifact步骤里添加name: github-pages参数，确保上传的Artifact名称符合部署动作的要求：

- name: Upload artifact
  uses: actions/upload-artifact@v4.0.0
  with:
    name: github-pages  # 必须指定这个名称
    path: '.'

次要警告：Environment URL为空 #

这个警告是因为Job级别的environment.url在deployment步骤执行前就被渲染，此时steps.deployment.outputs.page_url还没生成，所以是空字符串。

修复方法 #

有两种可选方案：

1. 移除手动设置的URL：actions/deploy-pages会自动把部署后的页面URL关联到github-pages环境，无需手动指定。修改Job的环境配置为：

   environment:
     name: github-pages
   

2. 保留URL但接受初始警告：如果需要显式指定URL，这个警告不影响功能，只是视觉提示，可忽略。

完整修正后的工作流配置 #

# Simple workflow for deploying static content to GitHub Pages
name: Deploy static content to Pages

on:
  push:
    branches: ["master"]
  workflow_dispatch:

permissions:
  contents: read
  pages: write
  id-token: write

concurrency:
  group: "pages"
  cancel-in-progress: true

jobs:
  deploy:
    environment:
      name: github-pages  # 移除手动设置的url，让deploy-pages自动关联
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v4.0.0
      - name: Setup Pages
        uses: actions/configure-pages@v4.0.0
      - name: Upload artifact
        uses: actions/upload-artifact@v4.0.0
        with:
          name: github-pages
          path: '.'
      - name: Deploy to GitHub Pages
        id: deployment
        uses: actions/deploy-pages@v2

额外说明 #

• 原工作流用的actions/upload-pages-artifact是GitHub Pages专用上传动作，会自动设置Artifact名为github-pages，而通用的actions/upload-artifact需要手动指定名称。
• 确保所有Actions版本保持兼容，actions/configure-pages@v4、actions/upload-artifact@v4、actions/deploy-pages@v2是当前稳定的兼容组合。

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