自定义Maven Wagon下载完整性校验失败排查求助

既然你的自定义Wagon上传后所有校验值都完全匹配，说明云存储里的原始文件和校验文件是没问题的，问题大概率出在HTTP访问链路的某个环节悄悄修改了文件内容。我给你梳理几个实用的排查方向：

• 先检查HTTP服务端的静态文件传输配置
  很多云存储自带的HTTP服务或者你配置的反向代理，很可能做了这些操作导致校验失败：

  • 有没有开启Gzip/Brotli压缩？如果给*.jar、*.pom这类二进制文件或者maven-metadata.xml开了压缩，下载到本地的是压缩后的内容，和原始文件的MD5肯定对不上。得把Maven仓库的所有文件路径排除在压缩规则之外。
  • 是否以文本模式处理了部分文件？比如有些服务会给XML、MD5这类文本文件自动转换换行符（把LF改成CRLF）或者添加BOM，这会直接改变文件的哈希值。要强制服务端以二进制传输模式处理所有仓库文件，不要做任何内容转换。

• 手动验证HTTP下载的文件和校验值
  用命令行工具手动下载文件，对比本地计算的哈希和校验文件，来定位问题点：

  # 下载目标jar和对应的md5文件（替换成你的仓库路径）
  curl -O http://your-repo-domain/com/your/group/artifact/1.0.0/artifact-1.0.0.jar
  curl -O http://your-repo-domain/com/your/group/artifact/1.0.0/artifact-1.0.0.jar.md5
  
  # 计算本地jar的MD5（Windows系统用certutil -hashfile filename MD5）
  md5sum artifact-1.0.0.jar
  
  # 查看校验文件内容
  cat artifact-1.0.0.jar.md5
  

  如果手动计算的MD5和校验文件不一致，说明HTTP传输中文件被篡改了；如果一致，那问题可能在Maven客户端的配置或者缓存。

• 排查Maven客户端的HTTP相关配置
  打开你的settings.xml检查这些细节：

  • 是否配置了<proxy>？代理服务器可能会对请求的文件做压缩或者修改，临时注释掉代理配置再试试拉取。
  • 镜像仓库<mirror>是否指向了中转仓库？如果镜像不是直接指向云存储的HTTP端点，而是经过了其他服务中转，可能被修改了文件内容。

• 确认云存储的HTTP访问路径是否正确
  有些云存储会给文件生成不同的URL，比如预览URL、分享URL，这些URL返回的内容可能经过格式转换等处理，不是原始文件。要确保Maven使用的是原始对象的直接访问URL，没有经过任何额外处理。

• 如果用了CDN，刷新缓存试试
  如果云存储前面挂了CDN，可能CDN缓存了旧的文件或者校验文件，导致拉取的内容和云存储里的最新版本不一致。先手动刷新CDN对应路径的缓存，再尝试拉取，或者直接访问云存储的源站URL跳过CDN验证。

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