Windows11下Jenkins触发脚本时浏览器自动无头运行求助

核心原因 #

Jenkins默认以Windows服务模式运行，该模式没有桌面交互权限，即使代码中禁用无头模式，浏览器也无法在前台显示UI，这是服务的系统限制，而非代码配置问题。

具体解决步骤 #

1. 修改Jenkins服务的桌面交互权限 #

• 按下Win+R输入services.msc打开Windows服务管理器
• 找到Jenkins服务，右键选择「属性」
• 切换到「登录」选项卡，选择「此账户」，输入当前登录的Windows管理员账户和密码
• 勾选「允许服务与桌面交互」，点击「确定」后重启Jenkins服务

2. 完善ChromeOptions配置 #

仅设置headless=false可能不足以覆盖服务环境的默认行为，需添加额外参数强制启用UI模式：

from selenium import webdriver
from selenium.webdriver.chrome.options import Options

chrome_options = Options()
# 显式禁用无头模式
chrome_options.headless = False
# 强制关闭无头模式（覆盖环境默认设置）
chrome_options.add_argument("--no-headless")
# 禁用沙箱（Windows服务环境下必需）
chrome_options.add_argument("--no-sandbox")
# 禁用GPU加速（避免服务环境渲染异常）
chrome_options.add_argument("--disable-gpu")
# 可选：指定Chrome安装路径，确保Jenkins能找到可执行文件
chrome_options.binary_location = r"C:\Program Files\Google\Chrome\Application\chrome.exe"

driver = webdriver.Chrome(options=chrome_options)
driver.get("https://example.com")

3. 验证Jenkins环境配置 #

• 在Jenkins流水线中添加环境变量检查步骤（Windows批处理示例）：

  echo %PATH%
  where chrome.exe
  where chromedriver.exe
  

  确保Chrome和ChromeDriver的路径已加入PATH，或在代码中显式指定路径

4. 确认ChromeDriver与Chrome版本兼容 #

ChromeDriver版本必须与本地安装的Chrome主版本完全匹配，版本不兼容会导致各种异常行为，建议下载对应版本的ChromeDriver替换现有文件

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