如何在Docker Linux容器中运行C# Selenium程序及问题解决

我来帮你搞定这个问题——在Linux容器里跑Selenium+Chrome确实容易踩坑，尤其是Chrome安装和无头模式配置这两块，我之前也踩过类似的坑，咱们一步步来解决：

一、问题根源拆解 #

你遇到的报错本质上是两个核心问题：

• Linux容器默认没有Chrome浏览器和对应的ChromeDriver，就算手动装了Chrome，也可能缺系统依赖库导致无法启动
• 无头模式的Chrome在Linux下需要特定的启动参数，和Windows环境的配置逻辑不一样

二、完整解决方案 #

1. 修正Dockerfile：正确安装Chrome、ChromeDriver及依赖 #

很多人只装了Chrome，但忽略了Linux运行Chrome需要的底层依赖，比如libglib2.0-0、libnss3这些，这就是为啥装了Chrome还报错的关键。下面是适配.NET项目的完整Dockerfile示例：

# 使用官方.NET SDK镜像构建项目
FROM mcr.microsoft.com/dotnet/sdk:6.0 AS build
WORKDIR /src
COPY ["SeleniumSample.csproj", "."]
RUN dotnet restore "./SeleniumSample.csproj"
COPY . .
WORKDIR "/src/."
RUN dotnet build "SeleniumSample.csproj" -c Release -o /app/build

# 发布项目
FROM build AS publish
RUN dotnet publish "SeleniumSample.csproj" -c Release -o /app/publish /p:UseAppHost=false

# 运行阶段：使用.NET Runtime镜像，安装Chrome和依赖
FROM mcr.microsoft.com/dotnet/runtime:6.0 AS final
WORKDIR /app
COPY --from=publish /app/publish .

# 安装Chrome、ChromeDriver及系统依赖
RUN apt-get update && apt-get install -y \
    wget \
    gnupg2 \
    unzip \
    && wget -q -O - https://dl-ssl.google.com/linux/linux_signing_key.pub | apt-key add - \
    && echo "deb 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 \
    # 下载对应版本的ChromeDriver（自动匹配Chrome版本）
    && CHROME_VERSION=$(google-chrome --version | grep -oP '\d+\.\d+\.\d+\.\d+') \
    && wget -O /tmp/chromedriver.zip https://chromedriver.storage.googleapis.com/$CHROME_VERSION/chromedriver_linux64.zip \
    && unzip /tmp/chromedriver.zip -d /usr/local/bin/ \
    && chmod +x /usr/local/bin/chromedriver \
    # 清理无用包，减小镜像体积
    && apt-get purge -y --auto-remove wget gnupg2 unzip \
    && rm -rf /var/lib/apt/lists/* /tmp/chromedriver.zip

# 设置环境变量，确保Selenium能找到ChromeDriver
ENV PATH=$PATH:/usr/local/bin

ENTRYPOINT ["dotnet", "SeleniumSample.dll"]

2. 调整C#代码：适配Linux无头Chrome #

你需要在代码里配置ChromeOptions，添加Linux环境必需的启动参数，比如--no-sandbox（容器里没有完整的用户环境，必须加这个参数）、--headless=new（新版Chrome的无头模式，比旧的--headless更稳定）。示例代码如下：

using OpenQA.Selenium;
using OpenQA.Selenium.Chrome;

class Program
{
    static void Main(string[] args)
    {
        var options = new ChromeOptions();
        // Linux容器下必需的核心参数
        options.AddArgument("--no-sandbox");
        options.AddArgument("--disable-dev-shm-usage"); // 解决容器内存不足导致的崩溃问题
        options.AddArgument("--headless=new"); // 新版无头模式，兼容性更好
        options.AddArgument("--disable-gpu"); // Linux环境无需GPU加速
        options.AddArgument("--window-size=1920,1080"); // 设置窗口大小，避免页面布局异常

        // 可选：手动指定Chrome二进制路径（防止Selenium自动查找失败）
        options.BinaryLocation = "/usr/bin/google-chrome";

        using (var driver = new ChromeDriver(options))
        {
            driver.Navigate().GoToUrl("https://www.example.com");
            Console.WriteLine(driver.Title);
            // 这里写你的业务逻辑
        }
    }
}

3. 确认Selenium包版本匹配 #

在SeleniumSample.csproj里，务必保证Selenium.WebDriver和Selenium.WebDriver.ChromeDriver的版本和你安装的Chrome版本兼容。比如Chrome是118.x，那ChromeDriver包也要用118.x版本：

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>net6.0</TargetFramework>
    <ImplicitUsings>enable</ImplicitUsings>
    <Nullable>enable</Nullable>
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="Selenium.WebDriver" Version="4.15.0" />
    <PackageReference Include="Selenium.WebDriver.ChromeDriver" Version="118.0.5993.7000" />
  </ItemGroup>
</Project>

三、验证步骤 #

1. 构建镜像：docker build -t selenium-sample .
2. 运行容器：docker run --rm selenium-sample

这样应该就能正常运行了——如果还有问题，大概率是Chrome和ChromeDriver版本不匹配，你可以进入容器执行google-chrome --version查看Chrome版本，然后对应下载正确的ChromeDriver版本即可。

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