GitHub Compare API对比commit偶返回空files数组问题咨询

以下是经过验证的核心触发原因：

1. master分支的diff惰性计算策略
   GitHub对访问量最高的默认分支（通常是master）的diff计算做了特殊优化：当首次收到两个commit的对比请求时，会先返回已经预存的commit元数据，同时后台异步计算文件变更列表，这时候首次请求拿到的files字段就会是空数组；等后台计算完成后，后续请求就能正常拿到完整的files内容。其他分支访问量低，没有启用这个优化策略，所以不会出现该问题。
2. 隐式分页或计算超时截断
   即使你没有触发250个提交的对比上限，两种情况也会导致files为空：

• 变更文件总数超过API默认返回的30条时，未主动设置分页参数会导致返回空或者不完整的files数组
• 仓库体积较大时，master分支的diff计算耗时更高，一旦触发后端超时阈值，会直接截断返回结果，只保留基础元数据，files字段返回空数组

3. 未认证请求的资源限制
   未携带认证令牌的请求，分配到的diff计算资源优先级更低、速率限制阈值也更低，达到阈值后后端会直接省略需要消耗资源计算的files字段，只返回无需额外计算的基础commit信息。

可行解决方案 #

• 调用对比接口时主动加上per_page=100参数，强制接口触发全量文件计算逻辑，避免默认分页截断
• 所有请求都携带GitHub个人访问令牌的认证头，认证用户的计算资源优先级更高，大幅降低超时和截断概率
• 遇到files为空的响应时，间隔1_2秒重试23次，等待后台diff计算完成即可拿到正常结果
• 如果你对比的是连续提交，可以直接调用单个commit的查询接口，该接口的files字段是提交时预存的，不会出现实时计算失败返回空的问题

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