容器化Express+Selenium应用报错：Server terminated early with status 255

问题分析 #

本地运行正常，但容器中访问/时Chrome启动失败，报错Server terminated early with status 255，核心原因包括：

• 容器环境缺少Chrome运行的必要系统依赖
• ChromeDriver与安装的Chrome版本不兼容
• 容器沙箱环境限制导致Chrome无法正常启动

解决方案 #

1. 完善Dockerfile中的Chrome依赖与版本同步 #

node官方镜像缺少Chrome运行所需的底层库，同时需确保ChromeDriver与Chrome版本严格匹配：

FROM node:18

# 安装Chrome及完整依赖，清理冗余文件减小镜像体积
RUN apt-get update && apt-get install -y \
    wget \
    gnupg \
    && wget -q -O - https://dl-ssl.google.com/linux/linux_signing_key.pub | apt-key add - \
    && echo "deb [arch=amd64] http://dl.google.com/linux/chrome/deb/ stable main" >> /etc/apt/sources.list.d/google.list \
    && apt-get update && apt-get install -y google-chrome-stable \
    && apt-get clean \
    && rm -rf /var/lib/apt/lists/*

WORKDIR /usr/src/app
COPY package*.json ./

# 安装生产依赖，用webdriver-manager自动同步对应版本的ChromeDriver
RUN npm install --only=production
RUN npx webdriver-manager update --gecko=false --versions.chrome=$(google-chrome --version | grep -oP '\d+\.\d+\.\d+\.\d+')

COPY . ./

# 创建非root用户运行（避免Chrome权限报错，提升安全性）
RUN useradd -m appuser
USER appuser

CMD [ "npm", "start" ]

2. 更新app.js中的Chrome启动参数 #

容器环境需要禁用沙箱、调整共享内存配置，补充必要启动参数：

import express from 'express';
import webdriver from 'selenium-webdriver';
import chrome from 'selenium-webdriver/chrome';

const app = express()
const port = process.env.PORT || 8080

app.get('/', async (req, res) => {
    console.log('Starting the browser')
    const options = new chrome.Options()
        .addArguments('--headless=new')
        .addArguments('--disable-gpu')
        .addArguments('--no-sandbox')  // 容器环境必须禁用沙箱
        .addArguments('--disable-dev-shm-usage')  // 解决容器/dev/shm空间不足问题
        .addArguments('--window-size=1920,1080');

    const driver = new webdriver.Builder()
        .forBrowser('chrome')
        .setChromeOptions(options)
        .build();

    try {
        await driver.get('https://google.com');
        res.send('Hello World!')
    } catch (err) {
        console.error('Browser operation failed:', err);
        res.status(500).send('Internal Server Error');
    } finally {
        await driver.quit();  // 确保无论成功失败都关闭浏览器实例
    }
})

app.get('/health', (req, res) => {
    res.send('OK')
});

app.listen(port, () => {
    console.log(`Example app listening on port ${port}`)
})

3. 调整package.json（可选） #

移除单独的chromedriver安装依赖，改用webdriver-manager自动管理版本：

"dependencies": {
    "express": "^4.18.2",
    "selenium-webdriver": "^4.18.1",
    "supabase": "^1.145.4"
  },
  "devDependencies": {
    "webdriver-manager": "^12.1.9"
  }

关键说明 #

• --no-sandbox：容器默认没有完整的Linux命名空间，必须禁用Chrome沙箱才能启动
• --disable-dev-shm-usage：容器的/dev/shm默认空间极小，会导致Chrome崩溃，该参数强制使用临时文件替代
• 版本同步：通过webdriver-manager根据已安装的Chrome版本自动下载匹配的ChromeDriver，彻底解决版本不兼容问题
• 非root运行：避免Chrome因权限限制无法启动，同时降低容器运行风险

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