Azure DevOps Git LFS大文件推送超时问题及原理疑问

为什么添加/info/lfs/objects/的access配置能解决超时问题 #

你的问题核心是大文件上传时，针对LFS对象存储端点的认证缺失导致服务器返回503错误。Azure DevOps的Git LFS服务中，<repo>/info/lfs/objects/是实际处理大文件对象上传/下载的核心端点，这个端点对认证的持续性要求比LFS根端点（<repo>.git/info/lfs）更高。

当你没有显式配置这个端点的认证方式时，Git LFS可能会沿用根端点的认证策略，但在长时间上传（超过120秒）过程中，认证会话会过期，或者请求没有正确携带认证信息，触发服务器的503错误。手动添加access = basic配置后，Git LFS会强制对该端点的所有请求使用Basic认证，确保每次上传请求都携带有效的凭证（比如你的Azure DevOps PAT或账号密码），避免认证失效导致的中断。

lfs.<url>.access配置的生效机制 #

Git LFS的配置采用路径匹配优先级，更具体的URL路径配置会覆盖通用路径的配置，具体逻辑如下：

• 默认自动生成的配置：首次与LFS服务器交互时，Git LFS会自动在.git/config中添加针对LFS根端点<repo>.git/info/lfs的access = basic配置，这个配置主要用于LFS的基础API交互（比如获取上传凭证、元数据同步）。
• 对象端点的特殊需求：大文件的实际上传请求是发送到<repo>/info/lfs/objects/这个更具体的端点，这个端点直接对接Azure DevOps的对象存储服务，对认证的持续性要求更高。如果没有针对该端点的显式配置，Git LFS可能无法正确传递认证信息到这个子路径，导致长时间上传时认证失效。
• 配置的自动生成触发条件：当上传成功完成时，Git LFS会自动记录这个对象端点的认证配置（也就是你看到同事机器上自动添加的那两行）。但如果上传超时失败，Git LFS没有机会完成这个自动配置过程，所以需要手动添加。

额外注意事项 #

• 针对Azure DevOps的Git LFS大文件上传，建议始终显式添加这个对象端点的配置，避免因网络波动导致的超时问题。
• 确保你的Git凭证管理器（比如Windows上的Git Credential Manager）已经正确保存了Azure DevOps的访问凭证，Basic认证会依赖这些凭证来生成请求头。

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