跨仓库调用Github Actions子Workflow提示Secret未定义问题排查

问题背景 #

同属一个组织的仓库1（父Workflow）调用仓库2（子Workflow），组织级别存储所需Secret，运行时出现Secret未定义的错误。

调用方Workflow #

jobs:
 download_secure_file:
   name: Download Secure File
   uses: MyOrg/BuildTemplates/.github/workflows/template-download-secure-file.yml@main
   secrets:
     CSSM_HW_FOODS_AZURE_CLIENT_ID: ${{ secrets.CSSM_HW_FOODS_AZURE_CLIENT_ID }}
     CSSM_HW_FOODS_AZURE_TENANT_ID: ${{ secrets.CSSM_HW_FOODS_AZURE_TENANT_ID }}
     CSSM_HW_FOODS_AZURE_SUBSCRIPTION_ID: ${{ secrets.CSSM_HW_FOODS_AZURE_SUBSCRIPTION_ID }}

被调用方Workflow #

name: DownloadSecureFile

on:
  workflow_call:
    outputs:
      secure_file:
        value: ${{ jobs.download_secure_file.outputs.file }}
    secrets:
      CSSM_HW_FOODS_AZURE_CLIENT_ID:
        required: true
      CSSM_HW_FOODS_AZURE_TENANT_ID:
        required: true
      CSSM_HW_FOODS_AZURE_SUBSCRIPTION_ID:
        required: true
env:
  AZURE_KEYVAULT_NAME: 'kv-rtl-sma-prod'
  AZURE_SECRET_NAME: 'keys'

错误信息 #

Invalid workflow file: .github/workflows/main.yml#L37
The workflow is not valid. .github/workflows/main.yml (Line: 37, Col: 38): Invalid secret, CSSM_HW_FOODS_AZURE_CLIENT_ID is not defined in the referenced workflow. .github/workflows/main.yml (Line: 38, Col: 38): Invalid secret, CSSM_HW_FOODS_AZURE_TENANT_ID is not defined in the referenced workflow.

问题原因排查 #

1. 被调用Workflow路径/分支错误：调用时指定的uses路径或分支（@main）可能指向了错误的文件版本，导致GitHub无法读取到正确的workflow_call.secrets定义。
2. 参数名不一致：实际文件中可能存在大小写、拼写或下划线的细微差异（GitHub Actions参数名区分大小写），即使示例中看起来一致。
3. Workflow缓存问题：GitHub可能缓存了旧的被调用Workflow定义，未拉取最新版本。
4. 组织Secret权限问题：仓库1可能未被授予访问组织级Secret的权限，但该场景下错误信息通常会提示Secret不存在而非未定义。

解决步骤 #

• 确认uses路径准确性：检查仓库名、文件路径、分支是否完全正确，确保main分支下的template-download-secure-file.yml确实包含完整的secrets定义。
• 逐字符核对参数名：对比调用方传递的secrets key与被调用方workflow_call.secrets中的定义，确保完全一致。
• 验证组织Secret权限：在组织设置的「Secrets and variables -> Actions」中，确认目标Secret的访问权限包含仓库1。
• 强制刷新Workflow：重新提交代码或手动触发Workflow，确保拉取最新的被调用Workflow文件。

是否需要提交GitHub问题 #

如果以上步骤全部排查完成，确认路径、参数、权限均无问题，但错误依然存在，大概率是GitHub Actions的平台bug，可提交问题到GitHub官方支持或Actions仓库的issues。

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