Docker内无头Firefox Selenium测试在Jenkins报GDK_BACKEND不匹配错误

我之前也遇到过类似的容器内Jenkins运行Selenium测试的坑，结合你的情况，咱们一步步拆解解决：

问题根源分析 #

你当前的启动命令是分开的两个sh指令：

sh "export DISPLAY=:1" 
sh "Xvfb :1 -screen 0 1440x900x24 &"

这里的核心问题是环境变量作用域隔离：每个sh命令都是独立的子shell，export DISPLAY=:1只在第一个子shell里生效，后续的Xvfb进程和Selenium测试根本拿不到这个变量。而本地运行时你是在同一个终端会话里操作，变量能正常传递，所以没问题，但Jenkins的流水线步骤默认是隔离的子进程，就会出现显示不匹配的错误。

另外，GDK_BACKEND does not match的提示说明Firefox可能默认尝试使用Wayland后端，而Xvfb提供的是X11虚拟显示，两者不兼容也会触发这个错误。

具体解决方案 #

1. 合并命令，确保环境变量在同一shell生效 #

把DISPLAY导出、GDK_BACKEND配置和Xvfb启动放在同一个sh命令里，让所有变量能被后续进程继承：

sh -c "export DISPLAY=:1 && export GDK_BACKEND=x11 && Xvfb :1 -screen 0 1440x900x24 &"

• export GDK_BACKEND=x11强制Firefox使用X11显示后端，和Xvfb完全兼容
• 用&&串联命令，确保变量设置完成后再启动Xvfb

2. Jenkins流水线全局环境变量配置（更可靠） #

如果用Jenkinsfile编写流水线，直接通过environment块设置全局环境变量，这样所有后续步骤都能自动拿到：

pipeline {
    agent any
    environment {
        DISPLAY = ":1"
        GDK_BACKEND = "x11"
    }
    stages {
        stage('启动虚拟显示') {
            steps {
                sh "Xvfb :1 -screen 0 1440x900x24 &"
                sh "sleep 2" // 给Xvfb一点启动时间
            }
        }
        stage('运行Selenium测试') {
            steps {
                // 替换成你的实际测试命令，比如mvn test、pytest等
                sh "mvn test"
            }
        }
    }
}

3. 验证环境变量是否生效 #

在测试启动前添加验证步骤，确认变量正确传递：

sh "echo 当前DISPLAY: $DISPLAY && echo 当前GDK_BACKEND: $GDK_BACKEND"

如果输出是当前DISPLAY: :1和当前GDK_BACKEND: x11，说明配置没问题。

为什么本地正常Jenkins出问题？ #

本地运行时，你是在同一个终端会话里执行所有命令，环境变量会在整个会话中传递；但Jenkins的每个sh步骤都是独立的子进程，默认不会继承前一个步骤的环境变量（除非用全局环境配置），这就是两者的核心差异。

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