GitHub Actions下workflow_dispatch输入的commit hash仅最新提交可通过验证

该问题的核心诱因是actions/checkout的默认克隆策略为浅度拉取：

• 当你未显式配置拉取深度时，actions/checkout@v2默认会设置fetch-depth: 1，仅将当前工作流对应触发分支的最新1条提交的Git对象下载到Runner本地的.git目录中，所有更早的历史提交、关联的Git对象都不会被同步到Runner环境。
• 你之前替换的几种Git校验命令本身写法没有问题，但Runner本地仓库不存在对应历史提交的对象，自然会抛出“非有效对象名”的报错。
• 本地环境校验能正常执行，是因为本地仓库通常为全量克隆，所有历史提交的Git对象都完整存储在本地，不存在对象缺失的问题。
• 只有最新提交能通过校验，也刚好匹配默认浅拉取仅存在最新1个提交对象的特性。

根据你的实际业务场景，可选择两种适配的修复方式：

场景1：校验后需要基于目标提交执行代码操作 #

如果校验完成后还要拉取对应提交的代码做构建、部署操作，直接调整Checkout步骤的拉取参数，确保本地仓库存在全量Git对象即可：

runs-on: ubuntu-latest
steps:
  - name: Checkout Project
    uses: actions/checkout@v4
    with:
      # 设置拉取深度为0，代表全量拉取所有分支、所有历史的提交对象
      fetch-depth: 0
      
  - name: Validate input commit hash
    if: ${{ github.event.inputs.sha != '' }}
    run: git cat-file -e ${{ github.event.inputs.sha }}^{commit}

拉取深度参数说明：

• fetch-depth: 1：默认值，仅拉取最新1条提交，无任何历史对象
• fetch-depth: N：拉取最近N条提交的历史，超出范围的更早提交依然无法被校验
• fetch-depth: 0：全量拉取仓库全部历史，可支持任意历史提交的对象校验

场景2：仅需做提交合法性校验，无需拉取完整代码 #

如果你的流程只是做sha合法性校验，不需要拉取对应提交的代码内容，大仓库下全量拉取耗时过长，可跳过本地仓库全量克隆步骤，直接通过远端Git接口做校验，无需同步任何历史对象：

runs-on: ubuntu-latest
steps:
  - name: Validate input commit hash
    if: ${{ github.event.inputs.sha != '' }}
    run: |
      # 通过远端ls-remote查询所有分支、Tag关联的提交SHA，匹配传入值是否存在
      git ls-remote origin | grep -q "${{ github.event.inputs.sha }}"

这种方式无需本地仓库存在对应对象，仅通过网络访问远端仓库的引用列表即可完成合法性校验，拉取耗时可以忽略不计。

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