如何通过GitHub Raw URL获取内容？Spring Boot RestTemplate遇404问题

可能的原因及对应解决方案 #

1. 请求头缺失被GitHub拦截 #

GitHub会对非浏览器标识的请求做拦截，返回404（并非资源真的不存在）。浏览器访问时会自动携带User-Agent头，但RestTemplate默认请求头没有这个字段。

解决方法：给请求添加浏览器风格的User-Agent头：

HttpHeaders headers = new HttpHeaders();
// 模拟Chrome浏览器的User-Agent，也可以用其他浏览器的标识
headers.set("User-Agent", "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/114.0.0.0 Safari/537.36");
HttpEntity<Void> httpEntity = new HttpEntity<>(headers);

// 发起请求
ResponseEntity<String> response = restTemplate.exchange(uri, HttpMethod.GET, httpEntity, String.class);

2. URL编码问题 #

如果Raw URL中包含特殊字符（比如空格、中文、特殊符号），直接使用字符串构建URI可能会导致编码错误，触发404。

解决方法：用UriComponentsBuilder正确构建URI：

URI validUri = UriComponentsBuilder.fromHttpUrl(rawUrl)
        .build()
        .encode()
        .toUri();

// 用这个编码后的URI发起请求
restTemplate.exchange(validUri, HttpMethod.GET, httpEntity, String.class);

3. 私有仓库未携带认证信息 #

如果目标仓库是私有仓库，浏览器因为已登录GitHub能访问，但RestTemplate请求时没有携带认证令牌，GitHub会返回404（私有资源未授权的伪装状态码）。

解决方法：添加GitHub个人访问令牌（PAT）到请求头：

headers.set("Authorization", "token 你的GitHub个人访问令牌");

注意：个人访问令牌需要拥有repo权限（针对私有仓库）。

4. 代理配置问题 #

如果你的网络需要代理才能访问GitHub，浏览器已配置代理但RestTemplate未配置，会导致请求无法到达GitHub，返回404。

解决方法：给RestTemplate配置代理：

SimpleClientHttpRequestFactory factory = new SimpleClientHttpRequestFactory();
Proxy proxy = new Proxy(Proxy.Type.HTTP, new InetSocketAddress("代理地址", 代理端口));
factory.setProxy(proxy);

RestTemplate restTemplate = new RestTemplate(factory);

排查步骤 #

1. 把Raw URL复制到Postman中，不带任何请求头发起请求，看是否返回404：
   • 若返回404，添加User-Agent头重试，能访问则是请求头问题；
   • 若仍返回404，检查仓库是否为私有，添加认证令牌重试；
2. 确认Raw URL中的提交SHA、文件路径是否正确（可通过浏览器再次验证）；
3. 检查RestTemplate的URI是否存在编码错误。

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