
本文详解 selenium grid 4.12.1 在单机环境下启动 hub 与 node 的完整流程,重点排查节点注册失败的常见原因,包括版本兼容性、驱动路径配置及浏览器-驱动匹配问题。
本文详解 selenium grid 4.12.1 在单机环境下启动 hub 与 node 的完整流程,重点排查节点注册失败的常见原因,包括版本兼容性、驱动路径配置及浏览器-驱动匹配问题。
Selenium Grid 4 已彻底重构为基于组件化架构(Hub/Node 模式被 standalone、hub、node 等独立服务取代),不再支持旧版“注册节点到 Hub”的命令语法。你截图中报错(很可能为 Unknown option: --role 或 Unable to create session)正是因沿用了 Grid 3 的启动方式,而 Grid 4 中节点需通过 selenium-server 的 node 命令显式连接 Hub,且对版本协同要求更严格。
✅ 正确启动步骤(以 Selenium Server 4.12.1 + ChromeDriver 126 为例):
-
启动 Hub(终端1):
java -jar selenium-server-4.12.1.jar hub --port 4444
访问
http://localhost:4444/ui可确认 Hub 运行正常。 -
启动 Node(终端2)——关键!必须显式指定 Hub 地址与驱动路径:
Build n8n workflows from node docs, templates, and schemas through MCP下载当代理需要在设计或调试工作流时结构化访问 n8n 节点、属性、操作和模板示例时,请使用 n8n-MCP,而不是通过原始文档猜测或手动点击 n8n UI。
java -jar selenium-server-4.12.1.jar node \ --publish-events tcp://localhost:4442 \ --subscribe-events tcp://localhost:4443 \ --hub http://localhost:4444 \ --detect-drivers true \ --driver-configuration display-name="chrome" \ max-sessions=5 \ stereotype='{"browserName": "chrome", "browserVersion": "126"}' \ implementation="org.openqa.selenium.chrome.ChromeDriver"✅
--detect-drivers true会自动扫描系统 PATH 中的chromedriver、geckodriver等;若手动指定,可加--config使用 JSON 配置文件。
⚠️ 必须验证的三大前提:
- 版本强兼容:Chrome 126 → 需 ChromeDriver 126.x(下载地址);Selenium 4.12.1 不兼容 Chrome 128。Firefox 同理,需匹配 GeckoDriver 版本矩阵。
-
PATH 真实生效:在终端执行
chromedriver --version,确保返回版本号而非command not found。Windows 用户需重启终端使环境变量生效。 -
无端口冲突/防火墙拦截:Grid 4 默认使用 4442–4444 端口,检查是否被占用(
netstat -ano | findstr :4444)。
? 排查技巧:
- 启动 Node 时添加
--log-level FINE查看详细日志; - 若提示
Failed to bind to address,说明端口被占,改用--host 127.0.0.1 --port 5555指定新端口; - 浏览器启动失败?尝试临时禁用沙箱:
stereotype='{"browserName":"chrome","goog:chromeOptions":{"args":["--no-sandbox","--disable-dev-shm-usage"]}}'。
? 总结:Grid 4 的节点不是“创建”,而是“注册服务”。核心在于——Hub 与 Node 的 Jar 包版本必须完全一致,驱动版本与浏览器严格对应,且所有网络端口双向可达。跳过任一环节,都会导致节点无法上线,UI 控制台将显示 0 active sessions。

















