Next.js站点部署至GitHub Pages失败，请求排查及解决方案

检查仓库GitHub Pages基础配置 #

• 打开仓库的「Settings」→「Pages」页面
• 确认「Source」选项已设置为「GitHub Actions」，而非「Deploy from a branch」等其他选项
• 若此前未启用Pages，先点击「Save」完成启用，确保站点状态正常

调整GitHub Actions工作流的enablement参数 #

报错中enablement: false表示该Action不会自动启用Pages站点，若你还未手动启用过Pages，建议将参数改为true，让Action自动完成启用配置：

- name: Set up pages
  uses: actions/configure-pages@v3
  with:
    static_site_generator: next
    token: ${{ secrets.GITHUB_TOKEN }}
    enablement: true

确认Next.js项目的静态导出配置 #

GitHub Pages仅支持静态资源，需确保项目配置了正确的静态导出规则：

• 在next.config.js中添加output: 'export'配置：

/** @type {import('next').NextConfig} */
const nextConfig = {
  output: 'export',
  // 其他项目配置...
}

module.exports = nextConfig

• 确保所有页面均为静态可导出组件，避免依赖服务器端渲染（SSR）、增量静态再生（ISR）等需要服务器支持的特性

重新触发部署 #

• 进入仓库「Actions」页面，找到失败的工作流，点击「Re-run jobs」重新执行部署
• 或推送一次代码变更，触发新的工作流运行

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