使用Curl配置GitHub分支保护时遭遇HTTP 401授权错误求助

核心问题拆解 #

从日志和脚本来看，导致401未授权的原因不止一个，逐个梳理：

1. 授权头格式错误
   GitHub OAuth2令牌的正确授权头前缀是Bearer，不是你用的Token。就算令牌填对，前缀错误也会导致授权失败。

2. 令牌变量未实际赋值
   脚本里OAUTH2_TOKEN=""是空字符串，日志里明确显示授权头为Token ""，等于没传有效凭证，这直接触发401。你说确认凭证正确，但脚本里并未填入真实令牌，或变量未正确传递。

3. API端点路径错误
   设置分支保护的正确GitHub API端点是/repos/${OWNER}/${REPO}/branches/main/protection，你的脚本里少了最后的/protection，请求的是分支信息接口而非分支保护设置接口，就算授权正确也会报错。

4. JSON请求体语法错误
   脚本里的JSON有两处语法问题：

   • required_status_checks里重复定义了contexts字段
   • 第一个contexts: []后未加逗号，导致JSON结构断裂，GitHub无法解析请求体

5. Content-Type头缺失
   请求自动带上了content-type: application/x-www-form-urlencoded，但发送JSON必须设置Content-Type: application/json，否则GitHub无法识别请求体格式。

修复后的完整脚本 #

#!/bin/bash

# 替换为你的真实凭证和仓库信息
OAUTH2_TOKEN="你的GitHub OAuth令牌"
OWNER="仓库所有者用户名"
REPO="仓库名称"

curl https://api.github.com/repos/${OWNER}/${REPO}/branches/main/protection \
    -X PUT \
    -H "Authorization: Bearer ${OAUTH2_TOKEN}" \
    -H "Accept: application/vnd.github+json" \
    -H "Content-Type: application/json" \
    -vv \
    -d '{
      "protection": {
        "enabled": true,
        "required_status_checks": {
          "strict": true,
          "enforcement_level": "everyone",
          "contexts": [
            "default"
          ]
        }
      }
    }'

额外注意事项 #

• 确保OAuth令牌拥有repo权限（私有仓库）或public_repo权限（公开仓库），权限不足也会返回401或403。
• 检查仓库所有者和名称是否拼写正确，避免因路径不存在导致报错。

内容的提问来源于stack exchange，提问作者Michal Škultéty