在.NET 5.0 Docker镜像中运行Playwright提示找不到浏览器可执行文件如何解决？

你遇到的报错是多阶段构建的文件隔离导致的。你在sdk镜像的build阶段执行npx playwright install下载的浏览器默认存储在/root/.cache/ms-playwright路径，该路径仅存在于build阶段的临时镜像层，没有被拷贝到最终运行容器使用的runtime镜像中，因此启动后找不到可执行文件。

正确修改方案 #

方案1：调整多阶段构建逻辑，拷贝浏览器缓存到运行镜像（推荐，镜像体积更小）

修改后的Dockerfile参考如下：

FROM mcr.microsoft.com/dotnet/runtime:5.0-buster-slim AS base
WORKDIR /app
# 提前安装Playwright运行所需的系统依赖
RUN apt-get update -yq && apt-get install -yq --no-install-recommends \
    libwoff1 libopus0 libwebp6 libwebpdemux2 libenchant1c2a libgudev-1.0-0 \
    libsecret-1-0 libhyphen0 libgdk-pixbuf2.0-0 libegl1 libgles2 libevent-2.1-6 \
    libnotify4 libxslt1.1 libvpx5 libxcomposite1 libatk1.0-0 libatk-bridge2.0-0 \
    libcups2 libdrm2 libdbus-1-3 libxkbcommon0 libxdamage1 libxfixes3 libxrandr2 \
    libgbm1 libasound2 libpangocairo-1.0-0 libpango-1.0-0 libcairo2 libatspi2.0-0 libgtk-3-0 \
    && rm -rf /var/lib/apt/lists/*

FROM mcr.microsoft.com/dotnet/sdk:5.0-buster-slim AS build
WORKDIR /src
COPY ["Agent.csproj", "Agent/"]
RUN dotnet restore "Agent/Agent.csproj"
COPY . "/src/Agent"
WORKDIR "/src/Agent"
RUN apt-get update -yq && apt-get upgrade -yq && apt-get install -yq curl git nano
RUN curl -sL https://deb.nodesource.com/setup_16.x | bash - && apt-get install -yq nodejs build-essential
RUN npm install -g npm

RUN dotnet add package Microsoft.Playwright
RUN dotnet build "Agent.csproj" -c Release -o /app/build
RUN npx playwright install

# 新增发布阶段
FROM build AS publish
RUN dotnet publish "Agent.csproj" -c Release -o /app/publish

# 最终运行镜像阶段
FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .
# 关键操作：把build阶段下载的浏览器缓存拷贝到运行镜像的对应路径
COPY --from=build /root/.cache/ms-playwright /root/.cache/ms-playwright
ENTRYPOINT ["dotnet", "Agent.dll"]

方案2：直接在运行阶段安装浏览器（操作简单但镜像体积更大）

如果不想手动管理依赖和文件拷贝，也可以把node环境安装、npx playwright install --with-deps命令直接放到base阶段执行，该方案会把node环境也打包到运行镜像中，适合对镜像体积不敏感的场景。

额外优化建议 #

可以在Dockerfile开头添加全局环境变量ENV PLAYWRIGHT_BROWSERS_PATH=/app/ms-playwright，统一指定浏览器的安装和读取路径，避免不同用户、不同阶段的缓存路径不一致导致的找不到文件问题。

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