Azure Pipeline错误选用Maven 3.5.4而非已安装的3.9.0问题排查

我们使用Azure DevOps Pipeline搭配Linux构建代理，已在代理上安装Maven 3.9.0且环境变量配置正常，但Pipeline默认运行时会选用Maven 3.5.4；仅当在Maven@3任务中指定自定义路径时才能正确调用3.9.0。已尝试重启构建代理但无效，需排查版本异常选用的原因。

相关YAML配置 #

未指定自定义Maven路径（Pipeline选用3.5.4） #

- task: Maven@3
  inputs:
    mavenPomFile: 'test Services/pom.xml'
    options: 'clean install org.owasp:dependency-check-maven:8.0.1:aggregate'
    publishJUnitResults: true
    javaHomeOption: 'JDKVersion'
    mavenVersionOption: 'Default'
    mavenAuthenticateFeed: false
    effectivePomSkip: false
    sonarQubeRunAnalysis: true
    sqMavenPluginVersionChoice: 'pom'

指定自定义Maven路径至3.9.0（可正确调用） #

- task: Maven@3
  inputs:
    mavenPomFile: 'test services/pom.xml'
    options: 'clean install org.owasp:dependency-check-maven:8.0.1:aggregate'
    publishJUnitResults: true
    javaHomeOption: 'JDKVersion'
    mavenVersionOption: 'Path'
    mavenDirectory: '/opt/apache-maven-3.9.0'
    mavenSetM2Home: false
    mavenAuthenticateFeed: false
    effectivePomSkip: false
    sonarQubeRunAnalysis: true
    sqMavenPluginVersionChoice: 'pom'

构建代理上的Maven命令执行结果（使用Pipeline运行账户） #

[test@Build01 ~]$ whereis mvn
mvn: /usr/bin/mvn /opt/apache-maven-3.9.0/bin/mvn.cmd /opt/apache-maven-3.9.0/bin/mvn /usr/share/man/man1/mvn.1.gz
[test@Build01 ~]$ mvn -v
Apache Maven 3.9.0 (9b58d2bad23a66be161c4664ef21ce219c2c8584)
Maven home: /opt/apache-maven-3.9.0
Java version: 17.0.5, vendor: Oracle Corporation, runtime: /opt/jdk-17/jdk-17.0.5
Default locale: en_US, platform encoding: UTF-8
OS name: "linux", version: "4.18.0-348.el8.x86_64", arch: "amd64", family: "unix"

排查方向及原因分析 #

1. Maven任务"Default"版本的逻辑问题 #

Maven@3任务的mavenVersionOption: 'Default'并非直接调用代理系统默认的Maven，而是优先遵循任务自身的版本检测逻辑：自托管代理场景下，任务会优先识别系统包管理器（如yum/apt）安装的Maven（即/usr/bin/mvn对应的3.5.4），而非手动解压安装的3.9.0。

2. Pipeline执行环境的环境变量差异 #

终端中执行mvn -v显示3.9.0，是因为加载了用户级配置文件（如.bashrc/.profile）中的PATH或M2_HOME配置，但Azure DevOps代理服务以非交互式shell启动，不会自动加载这些用户配置，导致PATH中/usr/bin的优先级高于/opt/apache-maven-3.9.0/bin，任务默认调用旧版本。

可以在Pipeline中添加脚本任务验证：

echo $PATH
echo $M2_HOME

对比终端输出，确认环境变量是否一致。

3. 代理工具缓存的干扰 #

Azure DevOps自托管代理会维护工具缓存目录（默认路径/azp/_work/_tool/Maven），如果代理曾安装过Maven 3.5.4，任务会优先调用缓存中的版本。可检查该目录是否存在3.5.4的缓存，若有则删除后重启代理再测试。

4. 系统包安装版本的优先级 #

/usr/bin/mvn是系统包安装的Maven 3.5.4，其路径在PATH中靠前，导致任务默认调用该版本。解决方式：

• 修改代理服务的启动环境变量，将/opt/apache-maven-3.9.0/bin放在/usr/bin之前；
• 卸载系统包安装的Maven 3.5.4，消除版本冲突。

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