Selenium Firefox Headless模式下如何启用并连接远程调试器

前置配置说明 #

你需要在初始化FirefoxOptions时添加3类核心启动参数，除了远程调试相关参数外，建议同步配置窗口尺寸参数，大概率可以直接解决你遇到的Headless模式元素遮挡报错（该问题通常是默认无头模式窗口尺寸远小于GUI模式，元素被挤出视口导致的）。

具体操作步骤 #

• 第一步：添加启动参数
  需添加的参数如下：

  • --headless=new：使用Firefox新版无头模式，旧版无头模式存在大量渲染兼容问题，不推荐使用
  • --remote-debugging-port=9222：指定远程调试端口，可自定义为未被占用的端口
  • --remote-debugging-address=127.0.0.1：指定调试服务监听地址，本地调试使用默认127.0.0.1即可
  • --window-size=1920,1080：固定窗口分辨率，匹配正常GUI模式的窗口尺寸，避免元素溢出视口

• 第二步：代码实现示例
  Python示例：

  from selenium import webdriver
  from selenium.webdriver.firefox.options import Options
  
  firefox_options = Options()
  firefox_options.add_argument("--headless=new")
  firefox_options.add_argument("--remote-debugging-port=9222")
  firefox_options.add_argument("--remote-debugging-address=127.0.0.1")
  firefox_options.add_argument("--window-size=1920,1080")
  
  driver = webdriver.Firefox(options=firefox_options)
  

  Java示例：

  import org.openqa.selenium.WebDriver;
  import org.openqa.selenium.firefox.FirefoxOptions;
  import org.openqa.selenium.firefox.FirefoxDriver;
  
  public class HeadlessDebugDemo {
      public static void main(String[] args) {
          FirefoxOptions options = new FirefoxOptions();
          options.addArguments("--headless=new");
          options.addArguments("--remote-debugging-port=9222");
          options.addArguments("--remote-debugging-address=127.0.0.1");
          options.addArguments("--window-size=1920,1080");
          WebDriver driver = new FirefoxDriver(options);
      }
  }
  

• 第三步：连接远程调试器
  启动Selenium驱动的无头Firefox实例后，打开本地GUI版的Firefox浏览器，地址栏输入about:debugging，选择「此Firefox」→ 点击「设置」按钮，添加网络位置localhost:9222，刷新页面后即可看到无头模式的Firefox实例，点击连接后就能查看对应标签页的渲染状态、用开发者工具排查元素相关问题。

注意：如果添加--window-size参数后元素遮挡报错直接消失，无需额外调试即可解决问题，该场景占Headless模式元素交互报错的90%以上。

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