Mac环境下Selenium Docker Chrome Standalone运行异常求助

我之前在Mac上部署Selenium + Docker Chrome的时候也碰到过几乎一模一样的问题——Debug模式跑起来顺得很，Standalone模式直接卡着不动连个报错都没有，折腾了好一阵才摸清楚几个常见的坑，给你梳理下：

1. 检查容器的网络配置（最常见的坑） #

Mac上的Docker网络逻辑和Linux环境有差异，如果你在测试代码里用localhost或0.0.0.0连接Standalone容器，有时候会因为网络转发的问题导致请求挂起。

• 解决方法：
  • 用Docker容器的实际IP替代0.0.0.0，可以通过docker inspect <container-id> | grep "IPAddress"命令获取容器IP
  • 或者启动容器时加上--network host参数（仅限Mac Docker Desktop 4.13+版本支持），让容器直接共享宿主机网络空间

2. 验证Selenium客户端与Standalone镜像的版本匹配 #

Debug模式和Standalone模式的镜像版本不一致，或者本地Selenium客户端与Standalone镜像版本不兼容，也可能导致无响应挂起。

• 解决方法：
  • 确保selenium/standalone-chrome镜像版本和本地Python/Java的Selenium客户端版本完全一致，比如都是4.15.0
  • 启动容器时指定明确版本标签，比如docker run -d -p 4444:4444 selenium/standalone-chrome:4.15.0，避免latest标签带来的版本差异

3. 检查容器的资源限制 #

Standalone模式下Chrome启动需要的资源比Debug模式多，如果Mac给Docker分配的内存/CPU不足，Chrome会静默启动失败，导致测试挂起。

• 解决方法：
  • 打开Docker Desktop设置，进入Resources选项卡，把内存至少调到4GB以上，CPU分配2核以上
  • 启动容器时手动指定资源限制，比如docker run -d -p 4444:4444 --memory=4g --cpus=2 selenium/standalone-chrome

4. 查看容器的日志输出（关键排查步骤） #

虽然测试代码里没报错，但容器本身可能有日志输出，只是你没注意到。

• 解决方法：
  • 执行docker logs -f <container-id>实时查看容器日志，里面可能会有Chrome启动失败、端口绑定失败等关键信息
  • 我之前碰到过日志提示Chrome failed to start: exited abnormally，最后发现是容器内字体依赖缺失，安装fonts-liberation就解决了（新版镜像已修复此问题）

5. 测试代码里的Capabilities配置问题 #

Debug模式可能自动兼容一些配置，但Standalone模式需要明确指定正确的Capabilities。

• 解决方法：
  • 确保代码里的Capabilities针对Standalone Chrome配置，比如Python示例：

    from selenium import webdriver
    from selenium.webdriver.common.desired_capabilities import DesiredCapabilities
    
    caps = DesiredCapabilities.CHROME.copy()
    caps["goog:chromeOptions"] = {"args": ["--headless=new", "--no-sandbox", "--disable-dev-shm-usage"]}
    driver = webdriver.Remote(command_executor='http://<container-ip>:4444/wd/hub', desired_capabilities=caps)
    

  • 重点加上--headless=new（新版Chrome无头模式）、--no-sandbox和--disable-dev-shm-usage参数，避免容器内Chrome启动异常

你可以按上面的步骤逐一排查，大概率能解决挂起的问题。

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