Jenkins构建Maven项目报错找不到Firefox二进制文件该如何解决

核心结论 #

不需要将Maven Project任务替换为Pipeline即可解决该报错，该问题和Jenkins任务类型无关，根因为构建节点环境缺失Firefox安装配置。

Cannot find firefox binary in PATH. Make sure firefox is installed 报错是自动化测试依赖的浏览器驱动（通常是Selenium GeckoDriver）在Jenkins构建节点的系统PATH环境变量中，未检索到Firefox可执行文件，和GitLab SSH拉取代码、代理网络环境、Jenkins任务类型均无直接关联。

排查修复步骤 #

• 第一步：确认构建节点的Firefox安装状态
  登录当前执行构建的Jenkins节点（主节点或分布式agent节点），执行命令 which firefox 查看是否返回Firefox的可执行文件路径，无返回则说明节点未安装Firefox，按对应操作系统的安装流程完成Firefox安装即可。
• 第二步：已安装Firefox仍报错的修复方案
  有两种可选配置方式，二选一即可：
  1. 直接在Maven Project任务中注入环境变量：进入任务配置页，找到「构建环境」板块，勾选「将环境变量注入到构建过程」，在变量输入框中添加PATH=$PATH:你的Firefox实际安装路径，Linux环境常见路径为/usr/bin或/usr/local/bin，Windows环境为Firefox安装根目录下的bin文件夹路径。
  2. 在测试代码中指定Firefox路径：以Java Selenium框架为例，在初始化Firefox驱动前添加代码 System.setProperty("webdriver.firefox.bin", "你的Firefox可执行文件完整路径") 即可。
• 补充说明：如果后续有更复杂的构建编排需求可以切换为Pipeline，但该操作无法直接解决当前报错，Pipeline场景下依然需要完成上述Firefox路径配置操作。

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