Azure自托管代理部署Java Spring Boot应用时无法识别Java的解决办法

以下是针对性的排查和解决步骤：

• 检查代理运行账户的环境变量
  Azure自托管代理如果以系统账户（Local System）运行，只会读取系统环境变量，不会加载当前用户的环境变量。

  1. 打开「系统属性」→「高级」→「环境变量」，将JAVA_HOME和M2_HOME添加到「系统变量」区域，同时把%JAVA_HOME%\bin和%M2_HOME%\bin追加到系统PATH变量中。
  2. 打开服务管理器（运行services.msc），找到「Azure Pipelines Agent」服务，右键重启。
  3. 验证：用代理运行的账户打开命令行（如果是系统账户，可通过psexec -s cmd.exe打开），执行java -version和mvn -v，确认命令能正常返回版本信息。

• 在管道中显式指定Java路径
  如果环境变量配置没问题，但管道任务仍无法识别，可在管道中通过JavaToolInstaller任务直接指定本地JDK路径：

  - task: JavaToolInstaller@0
    inputs:
      versionSpec: '17' # 替换为你安装的Java版本
      jdkArchitectureOption: 'x64'
      jdkSourceOption: 'LocalDirectory'
      jdkFile: 'C:\Program Files\Java\jdk-17.0.8' # 替换为你的JDK实际安装路径
  

  后续的Maven任务会自动使用这个指定的Java环境。

• 手动验证代理机器的命令执行
  把管道中的Maven命令（比如mvn clean package）复制出来，在代理机器上用代理运行的账户执行：

  • 如果执行报错，说明是代理机器的环境配置问题，回到第一步检查环境变量和权限；
  • 如果执行正常，检查管道配置中是否有覆盖环境变量的设置（比如任务的env参数修改了PATH或JAVA_HOME）。

• 确认JAVA_HOME的正确性
  确保JAVA_HOME指向JDK的根目录，而非JRE目录。例如正确路径是C:\Program Files\Java\jdk-17.0.8，不是C:\Program Files\Java\jdk-17.0.8\jre。同时检查PATH中%JAVA_HOME%\bin的位置，确保它在其他可能的Java路径之前，避免版本冲突。

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