Jenkins运行Cypress偶发缺失X server/$DISPLAY错误求助

针对你在Jenkins nightly build中遇到的Cypress偶发启动失败问题，以下是几个经过验证的解决方案：

1. 确保Xvfb完全初始化后再执行Cypress #

多数情况下错误是因为Xvfb还未完成启动，脚本就直接执行了Cypress命令。可以通过循环检查X服务状态，确认就绪后再继续：

# 生成随机DISPLAY端口
export DISPLAY=$(shuf -i 100-200 -n 1)
# 启动Xvfb并后台运行
Xvfb $DISPLAY -screen 0 1920x1080x24 &
XVFB_PID=$!

# 循环等待X服务就绪
until xset q >/dev/null 2>&1; do
    echo "等待Xvfb初始化完成..."
    sleep 1
done

# 执行Cypress测试
cypress run --record --key YOUR_RECORD_KEY

# 测试完成后清理Xvfb进程
kill $XVFB_PID

2. 替换为Cypress官方Docker镜像 #

Cypress官方提供了预配置好的Docker镜像，内置了所有依赖和Xvfb环境，完全不需要手动搭建，能从根源避免X服务相关问题：

pipeline {
    agent {
        docker {
            image 'cypress/included:13.6.0' // 替换为你的Cypress版本
            args '-v $PWD:/e2e -w /e2e'
        }
    }
    stages {
        stage('Run Cypress Tests') {
            steps {
                sh 'cypress run --record --key YOUR_RECORD_KEY'
            }
        }
    }
}

3. 清理残留的Xvfb进程 #

Jenkins节点可能残留之前构建的Xvfb进程，占用端口导致新构建失败。在脚本开头添加清理步骤：

# 强制清理所有Xvfb进程（无进程时不报错）
pkill -f Xvfb || true

4. 验证DISPLAY变量的一致性 #

检查脚本中是否存在意外覆盖DISPLAY变量的逻辑，确保从Xvfb启动到Cypress执行的整个流程中，该变量保持一致且未被修改。

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