使用GitHub API更新仓库内容遭遇409 Conflict错误，如何解决？

GitHub API更新文件返回409 Conflict，核心原因是更新已存在的文件时未提供目标文件当前的SHA哈希值——GitHub通过这个值校验你要修改的文件版本与远程仓库的版本是否一致，缺失或错误的SHA会触发冲突检测。

解决步骤： #

1. 获取目标文件的当前SHA值
   调用GET /repos/{owner}/{repo}/contents/{path}接口获取文件的元数据，响应中包含的sha字段就是当前文件的哈希值。
   示例代码（使用octokit）：

   const fileInfo = await octokit.request('GET /repos/{owner}/{repo}/contents/{path}', {
     owner: '你的GitHub用户名',
     repo: 'Hello-World',
     path: '需要更新的文件路径（如README.md）',
     headers: { 'X-GitHub-Api-Version': '2022-11-28' }
   });
   const currentSha = fileInfo.data.sha;
   

2. 携带SHA值发起更新请求
   调用PUT /repos/{owner}/{repo}/contents/{path}接口时，必须在参数中加入sha字段，值为上一步获取的当前文件SHA。同时注意文件内容需要Base64编码。
   示例代码：

   await octokit.request('PUT /repos/{owner}/{repo}/contents/{path}', {
     owner: '你的GitHub用户名',
     repo: 'Hello-World',
     path: '需要更新的文件路径',
     message: '更新文件内容',
     content: btoa('替换后的新内容'), // 明文内容需转Base64
     sha: currentSha, // 关键参数：确保与远程文件版本一致
     headers: { 'X-GitHub-Api-Version': '2022-11-28' }
   });
   

注意事项： #

• 若文件是首次创建，无需传入sha参数，接口会直接创建文件；仅更新已存在文件时需要sha。
• 如果在获取SHA到发起更新的间隙，文件被其他操作修改，仍会返回409，此时需要重新获取最新SHA后重试。
• 确保content参数为Base64编码字符串，不能直接传递明文内容。

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