Gerrit Get Content REST API返回404问题求助及替代方案咨询

我之前也碰到过这个404的坑，折腾了好一阵才搞定，分享下我的排查思路和替代方法：

一、先排查404的常见原因 #

这些细节很容易被忽略，也是导致404的主要原因：

• 项目名称/文件路径的URL编码：如果你的项目或文件路径里包含斜杠（/），必须用%2F替换。比如项目my/group/app要写成my%2Fgroup%2Fapp，文件src/utils/helper.js要转成src%2Futils%2Fhelper.js。
• 分支ID的完整格式：别只写分支名（比如master），要写完整的引用路径refs/heads/master，并且同样要编码成refs%2Fheads%2Fmaster。Gerrit的分支ID要求是完整的ref，不是短名称。
• 权限伪装的404：有时候权限不足也会返回404而不是403，建议先通过Gerrit网页确认你能访问目标项目的对应分支和文件，再检查请求的认证信息（比如HTTP Basic认证的用户名密码是否正确）。

二、正确的请求示例 #

举个实际的例子，假设：

• 项目名：demo-project
• 目标分支：refs/heads/main
• 目标文件：README.md

正确的请求URL应该是：

GET /projects/demo-project/branches/refs%2Fheads%2Fmain/files/README.md/content

请求头里记得带上认证信息，比如：

Authorization: Basic <你的用户名:密码的Base64编码>

三、替代的REST API下载方法 #

如果上面的接口还是有问题，可以试试这两个方案：

1. 通过文件元数据获取下载链接
   调用接口GET /projects/{project-name}/branches/{branch-id}/files/{file-id}，返回的JSON里会有download_url字段，直接请求这个URL就能拿到文件内容。注意这个URL同样需要认证。
2. 下载分支归档后提取文件
   如果需要批量下载或者不想处理单个文件的编码，用GET /projects/{project-name}/archive/{branch-id}.zip可以直接下载整个分支的ZIP归档，之后解压提取你需要的文件即可。

小提示 #

可以打开Gerrit自带的API文档（路径通常是/Documentation/rest-api.html），找到对应的接口，里面有在线测试功能（如果你的Gerrit实例开启了的话），能帮你快速验证请求格式是否正确。

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