Selenium Grid Firefox节点配置未读取moz:firefoxOptions问题

针对你遇到的Node配置里Firefox无头模式无法启用的问题，结合你使用的Windows Server 2016、Selenium 3.9.1、geckodriver 0.19.1和Firefox 59.0环境，我整理了几个关键排查点和正确配置方案：

1. 修正nodeconfig.json的层级结构 #

Selenium 3.x版本中，moz:firefoxOptions必须嵌套在capabilities数组内的Firefox专属配置里，放在全局或其他层级都会导致不生效。这是很多人踩坑的核心原因。

正确的配置文件示例：

{
  "capabilities": [
    {
      "browserName": "firefox",
      "maxInstances": 1,
      "seleniumProtocol": "WebDriver",
      "moz:firefoxOptions": {
        "args": ["--headless", "--disable-gpu"]
      }
    }
  ],
  "proxy": "org.openqa.grid.selenium.proxy.DefaultRemoteProxy",
  "maxSession": 1,
  "port": 5555,
  "register": true,
  "registerCycle": 5000,
  "hub": "http://<你的HubIP>:4444/grid/register"
}

注：Windows环境下无需--no-sandbox参数，--disable-gpu是Firefox 59启用无头模式的必要兼容参数。

2. 启动Node的正确命令 #

确保启动Node时指定配置文件，且没有用命令行参数覆盖配置内容：

java -jar selenium-server-standalone-3.9.1.jar -role node -nodeConfig nodeconfig.json

如果启动时额外添加了-browser参数，会直接覆盖配置文件里的capabilities，导致moz:firefoxOptions失效，务必避免这种操作。

3. 验证配置是否生效 #

你可以通过Hub的控制台（http://<HubIP>:4444/grid/console）查看Node的注册信息，检查Firefox的capabilities列表里是否包含moz:firefoxOptions的配置项。如果看不到，说明配置没被正确读取。

也可以编写简单的测试代码确认无头模式是否工作：

from selenium import webdriver
from selenium.webdriver.common.desired_capabilities import DesiredCapabilities

driver = webdriver.Remote(
    command_executor='http://<HubIP>:4444/wd/hub',
    desired_capabilities=DesiredCapabilities.FIREFOX
)
driver.get("https://www.google.com")
print(driver.title)
# 验证无头模式：查看服务器进程是否无Firefox窗口，或截图确认
driver.save_screenshot("firefox_headless_test.png")
driver.quit()

如果截图正常生成且无Firefox窗口弹出，说明无头模式已生效。

4. 补充：geckodriver路径配置 #

如果geckodriver未加入系统PATH，启动Node时需要通过参数指定路径，否则可能导致Firefox启动失败，让你误以为是无头配置问题：

java -Dwebdriver.gecko.driver="C:/path/to/geckodriver.exe" -jar selenium-server-standalone-3.9.1.jar -role node -nodeConfig nodeconfig.json

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