为何不同代理上执行相同Maven构建会产生不同结果？

首先纠正一个认知偏差：Java版本、Maven版本、源码版本、本地m2仓库完全一致，不代表必然输出哈希相同的构建产物，Maven构建过程受配置、环境变量、运行时上下文多个隐式因素影响，目前漏查的点按优先级排序如下：

• 校验Maven生效配置差异：目前仅清理了.m2/repository缓存目录，未校验两个环境下实际生效的Maven配置。Azure托管代理会预置全局settings.xml（覆盖路径包括$M2_HOME/conf/settings.xml、$AGENT_USER_HOME/.m2/settings.xml），默认内置Azure Artifacts源镜像、认证规则，部分镜像配置会附带全局依赖排除策略。直接在两个构建流水线中添加步骤执行mvn help:effective-settings，将输出的完整配置做文本对比，90%以上的跨环境依赖缺失问题都是全局配置不一致导致的。
• 校验依赖解析过程差异：在Maven构建命令中添加-e -X -U参数开启debug日志、强制检查依赖更新，同时执行mvn dependency:tree -Dverbose输出完整依赖树。重点核对两点：
  1. 托管代理构建日志中，缺失的对应依赖是否出现下载超时、403权限拒绝、校验和不匹配的记录——Maven遇到依赖下载失败时不会直接中断构建，若本地残留.lastUpdated标记文件会直接跳过该依赖，直到测试、打包阶段才抛出类找不到错误
  2. 两个环境输出的依赖树中，缺失依赖是否被标记为omitted for conflict（因版本冲突被仲裁排除），确认是否存在隐式的依赖版本判定差异
• 校验Maven Profile自动激活差异：Azure托管代理运行时会注入大量内置环境变量（如TF_BUILD=True、AGENT_ID、BUILD_BUILDID等），若pom.xml中存在基于环境变量、操作系统属性自动激活的profile，且profile中配置了依赖排除、打包跳过规则，就会直接导致产物差异。在两个流水线中执行mvn help:effective-pom输出最终生效的完整pom做diff，同时执行mvn help:active-profiles列出所有激活的profile做对比；也可以直接在构建命令中通过-P参数显式指定需要激活的profile，禁止隐式自动激活逻辑干扰。
• 校验运行时上下文一致性：
  1. 不要仅通过java -version校验Java版本，要确认mvn -v输出的Java home路径确实是JavaToolInstaller@0任务安装的JDK路径，避免Maven调用了系统预装的其他JDK版本
  2. 在构建步骤前执行env | sort输出全量环境变量做diff，确认不存在影响构建逻辑的自定义变量
  3. 执行ulimit -a对比两个环境的文件描述符限制、进程数限制，托管代理默认的ulimit阈值较低时，可能出现依赖解压失败、jar包写入不完整的问题，这类IO错误通常不会触发Maven显式报错
  4. 构建完成后直接定位WAR包中缺失的依赖对应jar文件，校验文件大小、执行jar tf <jar文件路径>确认包内类文件完整，排除文件写入损坏的问题
• 排除网络策略影响：Azure托管代理的出口网络经过Azure底层网络策略管控，访问公共Maven仓库时可能出现链接被重置、部分依赖包被拦截的情况，可以对照Maven debug日志中对应依赖的下载源地址，确认和自托管代理拉取的源地址完全一致。

内核版本的微小差异不会影响Java构建结果，不需要在这个方向浪费排查时间。

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