Ubuntu环境下Jenkins运行Selenium Firefox自动化测试失败求助

嘿，我碰到过一模一样的情况！这种在Eclipse里跑的顺但Jenkins卡壳的问题，基本都是Jenkins运行环境的特殊性搞的鬼。从你给出的日志来看，geckodriver已经成功启动并监听端口，但Firefox启动后没有后续测试执行，大概率是无桌面环境下Firefox无法渲染界面，给你几个针对性的解决步骤：

1. 启用Firefox无头模式（最推荐） #

Jenkins默认是在无GUI的环境下运行的，而Eclipse有桌面支持所以没问题。你需要在代码里给Firefox添加无头启动参数，这样不需要桌面也能运行测试：

// Java代码示例
FirefoxOptions firefoxOptions = new FirefoxOptions();
// 启用无头模式
firefoxOptions.addArguments("--headless");
// 部分Linux环境需要加这个参数避免GPU渲染问题
firefoxOptions.addArguments("--disable-gpu");
// 实例化Driver时传入配置
WebDriver driver = new FirefoxDriver(firefoxOptions);

2. 检查Jenkins用户的权限 #

Jenkins通常使用jenkins系统用户运行，可能没有访问Firefox或geckodriver的权限。你可以在Jenkins的构建步骤里先添加以下命令排查：

# 检查Firefox执行权限
ls -l /usr/lib/firefox/firefox
# 检查geckodriver执行权限（替换成你的geckodriver实际路径）
ls -l /usr/local/bin/geckodriver

如果权限不足，执行以下命令赋予执行权限：

sudo chmod +x /usr/local/bin/geckodriver

3. 验证Firefox与geckodriver版本兼容性 #

你的geckodriver版本是0.20.0，这个版本对应的Firefox版本应该是57.x - 60.x左右。如果Ubuntu上的Firefox版本过高或过低，会导致启动失败。可以在Jenkins里执行以下命令确认版本：

# 查看Firefox版本
firefox --version
# 查看geckodriver版本
geckodriver --version

如果版本不匹配，升级或降级其中一个即可（推荐优先升级geckodriver到对应Firefox的兼容版本）。

4. 配置虚拟显示（备用方案） #

如果不想用无头模式，你可以给Jenkins配置虚拟桌面环境。安装Xvfb工具，然后在Jenkins构建前添加以下命令：

# 启动虚拟显示
Xvfb :10 -ac &
# 设置DISPLAY环境变量
export DISPLAY=:10

也可以直接安装Jenkins的Xvfb插件，通过插件来管理虚拟桌面，更方便维护。

5. 查看完整错误日志 #

你提供的日志只到Firefox启动命令，后面可能有关键的报错信息没展示出来。建议查看Jenkins构建日志的完整内容，比如Firefox启动失败的具体原因（比如依赖库缺失），或者Selenium抛出的异常堆栈，这能帮你更精准定位问题。

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