GitHub Actions克隆仓库报错：无法读取HTTPS密码的原因排查

问题场景 #

我有一个名为FOO_SECRET的仓库密钥（是具有细粒度权限的个人访问令牌），执行以下GitHub Actions工作流步骤时失败：

- name: clone repo
  working-directory: /tmp
  shell: bash
  run: |
    git clone \
      --branch ${{ env.DEFAULT_BRANCH }} \
      --single-branch \
        https://${{ secrets.FOO_SECRET }}@${{ matrix.repository }}

报错信息：

fatal: could not read Password for 'https://***@github.com': No such device or address

核心原因及说明 #

• 细粒度令牌权限不足：细粒度个人访问令牌（PAT）需要针对目标仓库配置Contents读取权限。如果未授予该权限，Git会尝试触发交互式密码验证，但GitHub Actions运行环境没有交互终端，因此抛出该错误。
• 令牌含URL特殊字符未转义：若FOO_SECRET中的令牌包含@、:、%等URL保留字符，直接拼接进HTTPS URL会导致解析异常，Git无法识别有效令牌，进而触发密码读取请求。
• 矩阵变量格式错误：matrix.repository必须是仓库所有者/仓库名的完整格式，若格式缺失（如仅写仓库名），会导致URL无效，Git无法定位仓库，进而尝试请求密码验证。
• 密钥未正确注入工作流：如果FOO_SECRET未添加到仓库/组织的密钥列表，或者工作流未被授权访问该密钥，${{ secrets.FOO_SECRET }}会被解析为空字符串，Git会认为需要输入密码，无交互环境下报错。

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