Docker容器化后Puppeteer无法找到的问题求助

核心原因 #

Alpine Linux采用的是musl libc，但Puppeteer默认下载的Chrome浏览器是基于glibc编译的，二者底层依赖不兼容。即便文件路径正确，系统也无法识别并执行该二进制文件，因此会触发"No such file or directory"错误。

解决方案 #

方案1：改用Debian/Ubuntu基础镜像（推荐） #

这是最省心的方案，Debian/Ubuntu默认使用glibc，与Chrome依赖完全匹配：

1. 修改Dockerfile基础镜像，例如适配.NET 8的版本：mcr.microsoft.com/dotnet/runtime:8.0-bookworm-slim（根据你的项目框架版本调整）
2. 安装Chrome运行必需的系统依赖：

RUN apt-get update && apt-get install -y \
    libnss3 \
    libatk1.0-0 \
    libatk-bridge2.0-0 \
    libcups2 \
    libdrm2 \
    libxkbcommon0 \
    libxcomposite1 \
    libxdamage1 \
    libxrandr2 \
    libgbm1 \
    libasound2 \
    libpangocairo-1.0-0 \
    libxshmfence1 \
    && rm -rf /var/lib/apt/lists/*

方案2：在Alpine中添加glibc兼容层 #

如果必须使用Alpine镜像，可通过安装兼容包解决依赖问题：

1. 在Dockerfile中加入glibc安装命令：

# 安装glibc兼容层
RUN apk add --no-cache ca-certificates wget \
    && wget -q -O /etc/apk/keys/sgerrand.rsa.pub https://alpine-pkgs.sgerrand.com/sgerrand.rsa.pub \
    && wget https://github.com/sgerrand/alpine-pkg-glibc/releases/download/2.35-r0/glibc-2.35-r0.apk \
    && apk add glibc-2.35-r0.apk \
    && rm -rf glibc-2.35-r0.apk /etc/apk/keys/sgerrand.rsa.pub

2. 安装Chrome运行所需的其他系统依赖：

RUN apk add --no-cache \
    libstdc++ \
    libx11 \
    libxcomposite \
    libxdamage \
    libxext \
    libxfixes \
    libxrandr \
    libxrender \
    libxtst \
    nss \
    alsa-lib \
    mesa-gl \
    mesa-dri-swrast

额外配置优化 #

启动Puppeteer时，添加容器环境必需的参数：

var browser = await Puppeteer.LaunchAsync(new LaunchOptions
{
    Headless = true,
    ExecutablePath = browserFetcher.GetExecutablePath(installedBrowser.BuildId),
    Args = new[]
    {
        "--no-sandbox",
        "--disable-dev-shm-usage",
        "--disable-gpu",
        "--disable-setuid-sandbox"
    }
});

• --no-sandbox/--disable-setuid-sandbox：容器内通常无沙箱权限，必须禁用
• --disable-dev-shm-usage：避免容器内/dev/shm空间不足导致的崩溃

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