Apple Silicon/Arm架构下Docker化Cypress测试Chrome启动失败问题

问题根源 #

• cypress/browsers:latest镜像在Arm64架构下可能未预装适配的Chrome版本，或者Cypress无法自动检测到Chrome的可执行路径。
• 若构建/运行容器时未指定正确的Arm64平台参数，可能拉取x86架构的镜像，导致Chrome无法在M1设备上正常运行。

解决步骤 #

1. 更换适配Arm64的Cypress浏览器镜像 #

将Dockerfile中的基础镜像替换为官方明确支持Arm64的版本，比如包含Chrome 114的镜像：

FROM cypress/browsers:node18.16.0-chrome114-ff114-edge114

这类镜像已预装适配Arm64的Chrome、Firefox和Edge浏览器，无需额外安装。

2. 验证容器内Chrome状态 #

进入运行中的容器，执行命令确认Chrome是否安装：

docker exec -it projectName bash
# 检查Chrome可执行路径
which google-chrome
# 查看Chrome版本
google-chrome --version

如果返回有效路径（如/usr/bin/google-chrome），说明Chrome已安装，只需让Cypress识别它；若无返回，则需手动安装。

3. 手动安装Arm版Chrome（若需要） #

如果基础镜像未预装Chrome，在Dockerfile中添加Debian/Ubuntu系的安装命令：

RUN apt-get update && \
    apt-get install -y --no-install-recommends chromium-browser && \
    rm -rf /var/lib/apt/lists/*

安装完成后，在cypress.config.ts中指定Chrome的可执行路径：

import { defineConfig } from 'cypress'

export default defineConfig({
  e2e: {
    // 保留原有e2e配置
  },
  browsers: [
    {
      name: 'chrome',
      channel: 'stable',
      family: 'chromium',
      displayName: 'Chrome',
      version: '114.0.5735.198', // 替换为实际安装的版本号
      path: '/usr/bin/chromium-browser',
      majorVersion: '114'
    }
  ]
})

4. 确保容器平台参数正确 #

设置ARM_PLATFORM环境变量为--platform linux/arm64，确保构建和运行容器都使用Arm64架构：

export ARM_PLATFORM="--platform linux/arm64"

避免因平台不匹配导致拉取x86镜像，进而Chrome无法运行。

5. 修正容器路径映射 #

调整Makefile中start_docker_arm的挂载路径，与Dockerfile中的WORKDIR保持一致：

start_docker_arm:
    docker run ${ARM_PLATFORM} -d -t -i -v `pwd`/cypress:/projectName/cypress --name=projectName projectName

避免测试文件路径混乱影响Cypress执行。

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