我之前在Mac上折腾Selenium Docker环境时，也碰到过一模一样的问题——本地直接跑selenium-standalone startChrome好好的，一丢Docker容器里就启动失败，折腾了好一阵才理清原因，给你梳理下最常见的几个坑和解决办法：

一、版本不匹配（最常见！） #

Selenium、ChromeDriver、Chrome这三者的版本必须严格对应，差一个小版本都可能罢工。本地能正常运行，是因为你本地的Chrome和selenium-standalone自带的ChromeDriver版本完全适配，但Docker镜像里的Chrome/Selenium版本可能和你本地的不匹配。

解决步骤： #

1. 先查本地Chrome的版本：打开Chrome，输入chrome://settings/help就能看到（比如114.0.5735.198）
2. 选择对应大版本的Selenium官方镜像：比如你本地是114.x，就用selenium/standalone-chrome:114.0，别用latest（latest可能自动更新到更高版本，和你的测试代码依赖的Selenium版本不兼容）
3. 修改启动命令：

docker run -i -t -p 4444:4444 --rm --name e2e-test selenium/standalone-chrome:114.0

二、Linux容器缺少Chrome依赖库 #

Mac的系统依赖和Docker里的Linux环境完全不一样，Chrome在Linux下需要一堆基础库，有些镜像可能没预装全，导致启动失败。

解决办法： #

如果用的是自定义镜像，在Dockerfile里加上依赖安装步骤：

FROM selenium/standalone-chrome:你的目标版本
USER root
# 安装Chrome运行所需的依赖库
RUN apt-get update && apt-get install -y \
    libnss3 libatk1.0-0 libatk-bridge2.0-0 \
    libcups2 libdrm2 libxkbcommon0 \
    libxcomposite1 libxdamage1 libxrandr2 \
    libgbm1 libgtk-3-0 libasound2
USER seluser

如果用官方镜像，试试拉取最新的稳定版，官方一般会及时维护依赖，但偶尔也有遗漏的情况。

三、容器共享内存不足 #

Chrome启动需要足够的共享内存（/dev/shm），默认Docker给容器分配的shm太小，会直接导致Chrome崩溃。这个坑我当初踩了好久！

解决步骤： #

启动容器时加上--shm-size=2g参数，给Chrome足够的共享内存：

docker run -i -t -p 4444:4444 --rm --name e2e-test --shm-size=2g selenium/standalone-chrome:对应版本

四、Docker资源限制太低 #

如果Docker分配的内存、CPU太少，Chrome启动时会因为资源不足直接挂掉。

解决办法： #

打开Docker Desktop，进入Settings > Resources，把内存调到至少4GB，CPU调到2核以上，然后重启Docker再试。

实用排查小技巧 #

• 看容器日志找具体错误：执行docker logs e2e-test，日志里会明确告诉你Chrome启动失败的原因，比如“找不到libgbm.so”或者“ChromeDriver版本不支持当前Chrome”，根据日志定位问题比瞎试高效多了。
• 进入容器手动测试：执行docker exec -it e2e-test bash，然后运行google-chrome --headless --no-sandbox，看具体报错信息，能快速定位是依赖还是权限问题。

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