从Jenkins迁移至GitHub Actions的批量工作流触发问题排查

1. 克隆内部仓库的认证错误 #

fatal: could not read Username for 'https://github.vodafone.com': No such device or address这个错，核心是GitHub Actions克隆你的内部私有仓库时没有有效认证——哪怕是同平台的仓库，只要是私有/内部权限，都不能直接匿名克隆，必须提供合法凭据。

修复方案： #

• 用官方actions/checkout克隆跨仓库时，显式指定带权限的PAT：

  - name: 拉取目标内部仓库
    uses: actions/checkout@v4
    with:
      repository: vodafone/your-target-repo
      token: ${{ secrets.INTERNAL_REPO_PAT }}  # 提前在仓库Secrets里存好有仓库读写权限的PAT
      path: target-repo-dir
  

• 如果用原生git clone命令，直接把凭据嵌在URL里（别硬写，一定要用Secrets）：

  git clone https://${{ secrets.INTERNAL_REPO_PAT }}@github.vodafone.com/vodafone/your-target-repo.git
  

2. 源工作流多次触发目标工作流配置缓存 #

要实现多次触发，用workflow_dispatch事件配合GitHub API调用就行，以下是可直接复用的配置：

源工作流（触发端） #

name: 源触发工作流
on: [push, pull_request]

jobs:
  trigger-multiple-cache-jobs:
    runs-on: ubuntu-latest
    steps:
      - name: 循环触发目标工作流
        uses: actions/github-script@v7
        with:
          script: |
            // 这里示例触发3次，可根据需求调整循环次数
            const triggerCount = 3;
            for (let i = 0; i < triggerCount; i++) {
              await github.rest.actions.createWorkflowDispatch({
                owner: 'vodafone',
                repo: 'your-target-cache-repo',
                workflow_id: 'cache-setup-workflow.yml', // 目标工作流的文件名
                ref: 'main', // 触发的分支
                inputs: {
                  unique_cache_key: `build-cache-${i}-${{ github.sha }}` // 传唯一缓存键给目标工作流
                }
              });
              // 加个小延迟，避免触发频率超限
              await new Promise(resolve => setTimeout(resolve, 1000));
            }
          github-token: ${{ secrets.WORKFLOW_TRIGGER_PAT }} # 需要有repo和workflow权限的PAT

目标工作流（缓存配置端） #

name: 缓存配置工作流
on:
  workflow_dispatch:
    inputs:
      unique_cache_key:
        description: '唯一缓存标识键'
        required: true

jobs:
  setup-cache:
    runs-on: ubuntu-latest
    steps:
      - name: 检出代码
        uses: actions/checkout@v4

      - name: 配置依赖缓存
        uses: actions/cache@v3
        with:
          path: |
            node_modules
            ~/.gradle/caches
            # 根据你的技术栈添加缓存路径
          key: ${{ github.event.inputs.unique_cache_key }}
          restore-keys: |
            ${{ github.event.inputs.unique_cache_key }}-

      # 后续执行缓存预热或构建步骤...

3. 额外注意事项 #

• PAT权限要够：创建PAT时必须勾选repo和workflow权限，否则没法触发工作流或克隆内部仓库。
• 触发频率限制：GitHub对同一仓库的工作流触发有频次限制，多次触发时最好加个短延迟，避免被限流。
• 缓存键唯一性：每次触发传的缓存键必须唯一，不然不同触发实例会互相覆盖缓存，达不到预期效果。

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