调用GitHub API给仓库加星/取消星标返回404错误如何解决？

1. 确认API端点路径完全符合规范 #

GitHub 仓库star操作的官方端点为：

• 加星：PUT /user/starred/{owner}/{repo}
• 取消星标：DELETE /user/starred/{owner}/{repo}
  注意不要误写为/repos/{owner}/{repo}/star这类错误路径，同时需要保证owner（仓库所有者用户名）、repo（仓库名）的大小写和官方完全匹配，大小写不匹配会直接返回404。

2. 检查访问令牌（Token）权限配置 #

• 如果你使用的是经典PAT（Personal Access Token）：需要确保勾选了public_repo权限（操作公开仓库），操作私有仓库需要额外勾选repo完整权限。
• 如果你使用的是细粒度PAT：
  • 首先确认「Repository access」范围包含你要操作的目标仓库，不能仅设置为公开仓库权限
  • 其次在「Repository permissions」中找到Starring权限，设置为「Read and write」
• GitHub为了避免泄露私有仓库存在性，无权限访问的仓库和真实不存在的仓库都会返回404状态码，不会明确返回权限不足提示。

3. 检查请求头配置 #

必须包含两个关键请求头：

• 授权头格式必须正确：Authorization: token 你的实际令牌值，注意token关键字和令牌之间的空格不能省略，不要误写为Bearer前缀（部分GitHub API支持Bearer但star接口要求token前缀）
• 必须指定API版本头：X-GitHub-Api-Version: 2022-11-28，未指定版本会调用已下线的旧版接口返回404
• 加星的PUT请求不需要传请求体，设置Content-Length: 0即可，这个配置你已经做过是符合要求的。

4. 本地验证排除代码逻辑问题 #

你可以先通过curl命令直接测试接口可用性，排除Swift代码的参数拼接错误：

# 测试加星，替换为你的令牌、仓库所有者、仓库名
curl -L -X PUT \
  -H "Authorization: token 你的令牌" \
  -H "X-GitHub-Api-Version: 2022-11-28" \
  https://api.github.com/user/starred/所有者用户名/仓库名

如果curl执行成功，说明是你的Swift代码中存在请求头拼接错误、路径有多余空格/特殊字符等问题，重点排查请求构造逻辑即可。

内容的提问来源于stack exchange，提问作者V D O