GitHub Enterprise创建Release API返回401未授权，请求排查原因

在流水线中使用指定模板创建GitHub Enterprise版本时，调用API返回401未授权状态码，已知401代表未授权，但不清楚配置存在何种问题，希望了解该错误的具体原因。

流水线模板参数 #

- template: steps/git/github-create-release.yaml@templates
  parameters:
    githubRepo: client/SysInfo
    githubUrl: github.azc.ext.xx.com
    githubUser: winiotapp
    githubToken: $GithubToken
    assets: $BUILD_ARTIFACTSTAGINGDIRECTORY\\*.msi
    body: "System Information Release"
    draft: true
    name: "System Information"
    tagName: "1.0"

模板返回的错误信息 #

Creating a release at github.azc.ext.xx.com/api/v3/repos/client/SysInfo/releases with tagName [1.0] and name [System Information].

触发401的API调用代码 #

RESPONSE=$(curl -u ${{ parameters.githubUser }}:${{ parameters.githubToken }} \
          --location --request POST ${{ parameters.githubUrl }}/api/v3/repos/${{ parameters.githubRepo }}/releases \
          --header "Content-Type: application/json" \
          --data "$(release_parameters)" \
          -s -w "%{http_code}")
      STATUS=$(tail -n1 <<< "$RESPONSE")

备注 #

"winiotapp"是GitHub Enterprise用户名，且是仓库client/SysInfo的管理员，已生成对应的$GithubToken。

可能的错误原因及排查方向 #

• Token权限不足：创建Release需要repo权限（私有仓库）或public_repo权限（公有仓库），检查生成Token时是否勾选了对应权限，需确保包含repo:status、repo_deployment或完整的repo权限组。
• Token变量未正确注入：确认流水线中$GithubToken变量是否正确配置，模板是否能读取到有效值。可在流水线中添加打印步骤，输出${{ parameters.githubToken }}验证变量是否传递成功。
• GitHub URL缺失协议头：当前配置的githubUrl为github.azc.ext.xx.com，缺少https://协议头，curl请求可能无法正确解析地址，导致请求失败返回401。需修改为https://github.azc.ext.xx.com。
• 用户名与Token不匹配：确认winiotapp是该Token的所属用户，同时检查Token是否过期、被撤销或被修改。
• 仓库路径或权限问题：核对githubRepo参数client/SysInfo是否对应正确的仓库所有者和名称，确保该仓库存在，且当前用户对仓库拥有管理员权限（已确认，但可再次验证仓库访问权限）。
• 请求数据格式错误：检查release_parameters函数生成的JSON数据是否符合GitHub API要求的格式，虽然格式错误通常返回400，但也可能因请求无效触发401，可临时打印生成的JSON内容进行验证。

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