Ruby中如何将Selenium从无头模式改为正常可视化Chrome模式并解决启动报错

问题根因 #

你遇到的报错本质是两个场景的配置差异：

1. 直接初始化本地Chrome时缺少必要的启动参数，或者当前运行环境没有可用的图形渲染入口
2. 你之前用的remote模式连接的是容器内的无头Chrome实例，默认没有开启图形输出

解决方案 #

方案1：直接使用本地Chrome打开可视化窗口（无需remote） #

首先确认你的运行环境有图形界面（物理机桌面、WSL配置了X Server、远程服务器开启了桌面转发），且安装了完整版Chrome（不是仅无头版），修改代码如下：

options = Selenium::WebDriver::Chrome::Options.new
# 解决Linux环境下Chrome启动的沙箱权限问题，必加
options.add_argument('--no-sandbox')
# 解决/dev/shm分区不足导致的Chrome崩溃问题，必加
options.add_argument('--disable-dev-shm-usage')

# 如果你是WSL2/远程无桌面环境，需要提前配置X Server，然后取消下面的注释，替换为你的X Server地址
# ENV['DISPLAY'] = '127.0.0.1:0'

driver = Selenium::WebDriver.for(:chrome, options: options)
driver.get("https://www.google.co.jp/")

额外检查项：确保本地安装的Chrome版本和Selenium依赖的ChromeDriver版本完全匹配，版本不兼容也会触发启动异常。

方案2：继续使用remote Chrome容器，新增可视化入口 #

你当前用的remote Chrome容器默认是无头模式，替换为带VNC的debug版Chrome镜像即可：

• 启动容器时使用带debug标签的Selenium Chrome镜像，比如selenium/standalone-chrome:latest-debug，同时映射5900端口
• 安装VNC Viewer，连接localhost:5900（默认密码是secret）就能实时看到浏览器运行过程
• 原有remote连接的代码无需任何修改即可正常使用

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