Playwright项目打包Docker镜像后Firefox启动报错如何解决？

你遇到的报错是MacBook M1（arm64架构）设备运行x86/amd64架构的Playwright官方镜像导致的架构不兼容问题，原生x86编译的Firefox二进制在arm64模拟环境下无法正常启动，触发共享内存相关的系统调用报错。

方案1：使用适配arm64的Playwright官方镜像 #

你当前使用的mcr.microsoft.com/playwright:next标签版本过旧且未做明确架构适配，从基础镜像和配置层面修正即可：

• 把Dockerfile中的基础镜像替换为适配arm64的稳定版本，注意要和本地安装的Playwright大版本保持一致，比如1.35版本对应镜像为mcr.microsoft.com/playwright:v1.35.0-focal-arm64
• 移除Dockerfile中多余的RUN npx playwright install命令：官方Playwright镜像已经预装了对应版本的浏览器，重复安装会拉取x86版本的二进制，反而加重兼容问题

修改后的Dockerfile示例：

FROM mcr.microsoft.com/playwright:v1.35.0-focal-arm64

WORKDIR /app

COPY package.json package-lock.json ./

RUN npm ci

COPY . .

CMD ["node","index.js"]

方案2：强制Docker以x86模拟模式运行容器 #

如果暂时找不到对应arm64的镜像，可在运行容器时添加--platform linux/amd64参数强制使用x86模拟层运行：

docker run --platform linux/amd64 你的镜像名

注意该方案性能会有明显损耗，仅适合临时测试使用。

方案3：升级Playwright版本到1.30+ #

你当前使用的Playwright 1.15是2021年的旧版本，对arm64架构的适配非常不完善，升级到1.30及以上版本后，官方已默认支持arm64架构的Firefox、Chromium、WebKit内核，配合对应版本的arm64镜像可完全解决兼容问题。

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