Docker容器内WebDriver超时：Django+Gunicorn应用Selenium截图失败

嘿，我之前也踩过Docker+Selenium+Django的类似坑，结合你的情况，给你梳理几个大概率的问题点和对应的解决办法：

1. Docker容器缺失PhantomJS依赖 #

PhantomJS在Linux环境下需要依赖libfontconfig、libfreetype6这类系统库，如果你用的是轻量Python镜像（比如python:3.x-slim），默认是没有预装这些的，直接跑PhantomJS会失败。

• 解决方式：在Dockerfile里添加依赖安装命令：

RUN apt-get update && apt-get install -y --no-install-recommends \
    libfontconfig1 \
    libfreetype6 \
    && rm -rf /var/lib/apt/lists/*

2. PhantomJS路径配置问题 #

本地环境中PhantomJS可能在系统PATH里能直接找到，但Docker容器里如果是手动安装的，必须指定绝对路径才能启动。

• 解决方式：初始化webdriver时明确指定可执行文件路径：

from selenium import webdriver

# 假设PhantomJS放在/usr/local/bin目录下
driver = webdriver.PhantomJS(executable_path='/usr/local/bin/phantomjs')

3. Gunicorn多进程与Selenium的冲突 #

Gunicorn默认是多进程模式，而Selenium的webdriver实例并不是进程安全的。如果每个请求都创建新实例，很容易出现资源竞争、进程阻塞的情况，导致截图功能失效。

• 解决方式：
  • 测试阶段可以临时把Gunicorn改成单进程：gunicorn --workers=1 your_project.wsgi
  • 生产环境更推荐用进程池管理webdriver实例，或者让每个worker只初始化一个实例（注意线程安全）
  • 更优方案：直接换掉PhantomJS（它已经停止维护了），改用无头Chrome/Firefox，稳定性和兼容性都更好

4. 容器内部网络访问问题 #

如果你的截图URL是指向本地Django应用（比如http://localhost:8000/xxx），在Docker容器里localhost指向容器自身，而Gunicorn可能绑定的是0.0.0.0，或者容器内部端口和你预期的不一致，导致无法访问页面。

• 解决方式：用容器内部可访问的地址，比如http://127.0.0.1:8000/xxx（如果Gunicorn绑定的是8000端口）；如果用Docker Compose部署，也可以用服务名来访问。

5. 权限不足问题 #

Docker容器里运行Gunicorn的用户可能没有PhantomJS的执行权限，或者截图保存目录没有读写权限，导致无法生成或保存截图。

• 解决方式：确保PhantomJS有可执行权限（chmod +x /usr/local/bin/phantomjs），同时给截图保存目录分配对应用户的读写权限。

额外推荐：替换PhantomJS为无头Chrome #

PhantomJS已经被官方废弃，无头Chrome是更现代稳定的选择，给你个示例代码：

from selenium import webdriver
from selenium.webdriver.chrome.options import Options

chrome_options = Options()
chrome_options.add_argument('--headless')
chrome_options.add_argument('--no-sandbox')  # Docker环境下必须加这个参数
chrome_options.add_argument('--disable-dev-shm-usage')
driver = webdriver.Chrome(options=chrome_options)
driver.set_window_size(1024, 768)
driver.get(url)

对应的Dockerfile需要安装Chrome相关依赖：

RUN apt-get update && apt-get install -y --no-install-recommends \
    chromium \
    chromium-driver \
    && rm -rf /var/lib/apt/lists/*

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