GitHub可复用工作流被误识别为复合工作流的问题排查

问题出在调用可复用工作流的语法上：你用了相对路径但未指定版本引用，导致GitHub Actions误将其当作**复合动作（Composite Action）**处理，而非可复用工作流。

修复步骤 #

修改pkg.yml中调用可复用工作流的uses字段，在路径后添加仓库引用（如分支名、标签或commit SHA），即使是同一仓库也必须指定：

原错误代码片段：

- uses: ./.github/workflows/reusable/build_python_package.yml
  with:
    package_name: ${{ github.GITHUB_WORKFLOW }}

修改后：

- uses: ./.github/workflows/reusable/build_python_package.yml@main
  with:
    package_name: ${{ github.GITHUB_WORKFLOW }}

原因说明 #

• 仅用相对路径（如./.github/workflows/...）的uses语法，是用来调用本地复合动作的，GitHub会尝试在该路径下查找action.yml/action.yaml或Dockerfile，这正是你看到报错的原因。
• 调用可复用工作流时，uses字段必须包含版本引用（@+分支/标签/commit），即使是同一仓库的工作流也不例外。这样GitHub才会识别为可复用工作流，而非复合动作。

验证修改后的完整pkg.yml #

---
name: pkg
run-name: ${{ github.actor }} is building package_name
on:
  pull_request:
    branches: [main]
    paths: [pkg/**]
  push:
    paths: [pkg/**]
  workflow_dispatch:
jobs:
  main:
    runs-on: ubuntu-20.04
    steps:
      - name: Checkout code
        uses: actions/checkout@v4
      - uses: ./.github/workflows/reusable/build_python_package.yml@main
        with:
          package_name: ${{ github.GITHUB_WORKFLOW }}

你的可复用工作流build_python_package.yml本身没有问题，只要调用方式正确，就能被正确识别为可复用工作流执行。

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