GitHub Actions调用可重用工作流时版本未指定错误排查

问题场景 #

在同组织私有仓库中调用另一私有仓库的可重用工作流，已传入@main作为ref，目标文件确实存在于main分支，组织内跨仓库工作流调用权限已启用，尝试过提交哈希替代分支名，但仍触发"Invalid value workflow reference: no version specified"错误。

调用方工作流代码 #

name: dev-mule-app-deployment-pipeline
run-name: ${{ github.actor }} ran pipeline for Mulesoft application deployment to development
on:
    push:
        branches:
            - main
        paths-ignore:
            - ".github/**"
    workflow_dispatch:

jobs:
    call-common-pipeline:
        uses: <org-name>/<repo-name>/.github/workflows/rM_muleAppDeploy.yml@main
        with:
            DEPLOYMENT_PROPERTIES_PATH: ".github/deployment.properties"
            TARGET_ENVIRONMENT: "development"
        secrets: inherit

可重用工作流的workflow_call触发器代码 #

name: build-mule-deploy-pipeline
run-name: ${{github.actor}} started pipeline for deployment of mule application.

on:
    workflow_call:
        inputs:
            DEPLOYMENT_PROPERTIES_PATH:
                required: true
                type: string
            TARGET_ENVIRONMENT:
                required: true
                type: string

jobs:
    setup-settings:
.
.
.

其他可能的排查方向 #

• 路径/文件名大小写或拼写错误：GitHub对文件名和路径区分大小写，确认调用时的路径<org-name>/<repo-name>/.github/workflows/rM_muleAppDeploy.yml与目标仓库的实际文件路径、文件名完全一致，包括大小写、下划线等细节。
• 调用方仓库的Actions权限限制：进入调用方仓库的「Settings」→「Actions」→「General」，检查「Workflow permissions」是否配置为允许读取仓库内容，以及是否开启了跨仓库工作流调用的权限；同时确认仓库是否有自定义规则阻止了跨仓库调用。
• 目标分支的保护规则干扰：如果目标仓库的main分支设置了严格的分支保护（如强制PR合并、签名验证等），可能导致GitHub无法正常解析分支引用。尝试使用标签版本（如@v1.0.0）替代分支名或提交哈希，标签是静态引用，不受分支保护规则影响。
• GitHub系统缓存或延迟：刚修改工作流或分支内容后，GitHub的缓存可能导致引用解析异常。尝试重新触发工作流（手动运行workflow_dispatch），或等待一段时间后重试；使用main分支的完整最新提交哈希也能绕过缓存问题。
• 可重用工作流的隐性语法错误：检查目标工作流的workflow_call定义是否存在缩进错误、语法遗漏（比如用tab代替空格），或者工作流本身是否能在目标仓库内正常触发。如果目标工作流本身有语法问题，可能会返回误导性的错误提示。
• SAML单点登录权限限制：若组织启用了SAML SSO，需确认调用方仓库的GitHub Actions token已完成SAML授权，或在仓库「Settings」→「Actions」→「Access tokens」中配置了能访问目标私有仓库的有效token。

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