Jenkins执行Cypress headed模式未启动浏览器，如何实现CI跨浏览器测试

该问题核心是Windows环境下Jenkins服务默认无GUI交互权限，按以下步骤修复即可：

• 调整Jenkins服务运行权限：打开Windows服务面板（运行输入services.msc），找到Jenkins服务，右键选择「属性」→ 切换到「登录」选项卡，勾选「允许服务与桌面交互」，同时将服务运行账号从默认的Local System切换为你当前登录Windows的个人账号，修改完成后重启Jenkins服务。
• 修正命令路径：你所使用的命令存在路径拼写缺失，正确的Windows环境执行命令为.\node_modules\.bin\cypress run --headed --browser edge --env NO_COLOR=1，同时确认Jenkins执行任务的工作目录与你本地执行命令的项目根目录一致，确保可以正常识别node_modules下的Cypress执行文件。
• 增加调试参数验证：可在命令后追加--verbose参数查看Cypress运行日志，确认--headed参数被正常识别，排查是否存在CYPRESS_RUN_HEADLESS一类的全局环境变量强制覆盖命令行参数的情况。

• 前置依赖准备：在Jenkins运行节点（本次为你的本地Windows机器）提前安装所有需要测试的浏览器（Chrome、Edge、Firefox等），将浏览器执行路径加入系统环境变量，确保Cypress可以自动识别；也可以在命令中通过--browser参数直接指定浏览器可执行文件的绝对路径。
• Jenkins任务配置：
  • 自由风格项目可按浏览器维度拆分多个Windows批处理执行步骤，也可编写批处理脚本循环执行不同浏览器的测试命令。
  • Pipeline项目可通过矩阵配置实现多浏览器并行测试，大幅提升执行效率，参考配置如下：

pipeline {
    agent any
    stages {
        stage('安装依赖') {
            steps {
                bat 'npm install'
            }
        }
        stage('跨浏览器测试') {
            matrix {
                axes {
                    axis {
                        name 'BROWSER'
                        values 'chrome', 'edge', 'firefox'
                    }
                }
                steps {
                    bat ".\\node_modules\\.bin\\cypress run --headed --browser ${BROWSER} --env NO_COLOR=1"
                }
            }
        }
    }
}

• 测试结果归档：在Jenkins任务中配置「归档构件」，将Cypress生成的cypress/screenshots、cypress/videos目录和测试报告文件存档，方便执行失败后排查问题。
• CI环境优化建议：如果无需实时查看GUI运行过程，CI环境优先使用headless模式执行，只需去掉--headed参数即可，资源占用更低、运行稳定性更高，测试结果与headed模式完全一致。

内容的提问来源于stack exchange，提问作者Andrea Paolo Ferraresi