在Jenkins上运行Maven JUnit测试时哈希函数输出不一致问题排查

核心原因1：测试文件在Jenkins环境中内容不一致 #

本地与Jenkins上的file.xml实际字节流差异是哈希结果不一致的最常见诱因，具体可能包括：

• 换行符自动转换：本地Windows环境文件使用\r\n换行，Jenkins Linux节点拉取代码时Git自动将换行符转为\n，导致文件字节内容改变。
• Maven资源过滤篡改：若pom.xml中maven-resources-plugin开启了filtering=true，会替换文件中的变量（如${xxx}格式内容），直接修改文件原始字节流。
• 代码拉取或构建变更：Jenkins拉取的代码分支/版本与本地不一致，或构建过程中其他插件修改了测试文件。

验证与修复 #

• 验证文件一致性：本地执行certutil -hashfile path/to/file.xml MD5（Windows）或md5sum path/to/file.xml（Linux），在Jenkins工作区执行相同命令对比结果。
• 禁止换行符转换：在Git仓库配置core.autocrlf=false，确保文件字节流跨环境一致。
• 关闭测试资源过滤：在pom.xml中修改测试资源配置，避免文件被篡改：

<build>
  <testResources>
    <testResource>
      <directory>src/test/resources</directory>
      <filtering>false</filtering>
    </testResource>
  </testResources>
</build>

核心原因2：加密提供方重复加载导致优先级混乱 #

每次调用hash方法都重复添加BouncyCastleProvider和GnuCrypto，会导致Java安全提供方列表中出现重复实例，不同环境下的Provider优先级可能不同，进而使用不同的MessageDigest实现（虽MD5算法标准，但极端场景下存在实现差异）。

修复方式 #

将Provider初始化移至静态代码块，仅加载一次：

public class HashService {
    static {
        // 避免重复添加相同Provider
        if (Security.getProvider(BouncyCastleProvider.PROVIDER_NAME) == null) {
            Security.addProvider(new BouncyCastleProvider());
        }
        if (Security.getProvider(GnuCrypto.PROVIDER_NAME) == null) {
            Security.addProvider(new GnuCrypto());
        }
    }

    public String hash(ByteArrayResource obj, String algorithm) throws NoSuchAlgorithmException {
        var md = MessageDigest.getInstance(algorithm);
        // 后续逻辑不变
    }
}

也可强制指定Provider实现，消除环境差异：

var md = MessageDigest.getInstance(algorithm, BouncyCastleProvider.PROVIDER_NAME);

核心原因3：测试文件路径依赖工作目录（forkCount=0时找不到文件） #

设置forkCount=0时，测试进程与Maven进程共用JVM，Path.of("path/to/file.xml")的相对路径依赖当前工作目录。Jenkins构建的工作目录可能与本地不同，且若测试资源未复制到target目录，就会出现文件找不到的异常。

修复方式 #

通过类加载器读取测试资源，确保路径跨环境有效：

// 测试代码修改为类路径读取，需将file.xml放在src/test/resources下
InputStream is = getClass().getResourceAsStream("/file.xml");
byte[] bytes = is.readAllBytes();

额外排查点 #

• 核对Jenkins与本地的Java小版本（如Java11.0.1 vs 11.0.15），确保完全一致。
• 执行mvn dependency:tree对比本地与Jenkins的依赖树，确认BouncyCastle、GnuCrypto的版本无差异。

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