Ubuntu 16.04服务器上Jenkins无法运行Maven项目求助

首先，你遇到的核心问题是snap安装的Jenkins无法读取系统全局配置的环境变量——snap应用自带隔离环境，不会自动加载/etc/environment里的配置。下面给你几个可行的解决办法：

方法一：在Jenkins全局工具配置中指定Maven路径 #

这是最直接稳妥的方式，让Jenkins明确知道Maven的具体位置：

• 登录Jenkins后台，进入Manage Jenkins > Global Tool Configuration
• 找到Maven板块，点击Add Maven，取消勾选Install automatically
• 在MAVEN_HOME中填入你实际的Maven安装路径（比如/usr/local/apache-maven-3.8.6，你可以在服务器终端用which mvn查到路径后，去掉末尾的/bin/mvn就是MAVEN_HOME）
• 保存配置后，重新触发构建即可

方法二：给Jenkins的snap实例单独配置环境变量 #

针对snap的隔离特性，我们可以给Jenkins的snap包单独添加环境变量：

1. 在服务器终端创建snap的环境配置目录和文件：

   sudo mkdir -p /var/snap/jenkins/current/.profile.d
   sudo nano /var/snap/jenkins/current/.profile.d/maven.sh
   

2. 在文件中写入Java和Maven的环境变量（替换成你实际的安装路径）：

   export JAVA_HOME=/path/to/your/jdk
   export MAVEN_HOME=/path/to/your/maven
   export PATH=$MAVEN_HOME/bin:$JAVA_HOME/bin:$PATH
   

3. 重启Jenkins服务让配置生效：

   sudo snap restart jenkins
   

4. 可以在Jenkins后台的Manage Jenkins > System Information里检查PATH变量，确认已包含Maven的bin目录

方法三：通过Jenkins启动参数注入环境变量 #

如果前两种方法无效，还可以修改Jenkins的启动参数来强制注入环境变量：

1. 编辑Jenkins的snap配置文件：

   sudo nano /var/snap/jenkins/current/config/jenkins.conf
   

2. 在JAVA_ARGS后添加环境变量参数，示例如下：

   JAVA_ARGS="-Djava.awt.headless=true -DJAVA_HOME=/path/to/your/jdk -DMAVEN_HOME=/path/to/your/maven"
   

3. 同时进入Jenkins后台的Manage Jenkins > Configure System，找到Global properties，勾选Environment variables，添加一个键为PATH、值为$MAVEN_HOME/bin:$JAVA_HOME/bin:$PATH的变量
4. 保存配置后重启Jenkins服务

额外检查点 #

• 切换到jenkins用户测试命令：在服务器终端执行sudo su - jenkins -s /bin/bash切换到jenkins用户，然后运行mvn -v。如果也找不到命令，说明jenkins用户本身未加载到环境变量，方法二会是最优解
• 不要依赖/etc/environment的全局配置自动被Jenkins读取——snap的隔离机制会阻止这种全局配置的加载

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