容器化Cypress测试报告存为Bitbucket Pipeline工件遇阻求助

问题描述 #

将Cypress测试结果持久化为Bitbucket Pipeline工件时失败，已确认Cypress保存报告的文件夹路径正确，推测问题出在容器到Pipeline工作区的卷映射环节。

相关配置 #

Bitbucket Pipeline配置 (bitbucket.yml) #

pipelines:
  custom:
    e2e:
      - step:
          services:
            - docker
          script:
            - mkdir -p cypress-reports/screenshots cypress-reports/mochawesome-report
            - docker-compose -f docker-compose.e2e.yml up -d
          artifacts:
            - cypress-reports/**

Docker Compose配置 (docker-compose.e2e.yml) #

services:
  cypress:
    build: 
      context: .
    volumes:
      - ./cypress-reports/screenshots:/cypress/screenshots
      - ./cypress-reports/mochawesome-report:/mochawesome-report

排查方向与解决方案 #

1. 容器后台启动导致Pipeline提前结束 #

使用docker-compose up -d会让容器在后台运行，Bitbucket Pipeline可能在Cypress测试完成前就进入工件收集阶段，此时报告尚未生成。

解决：改为前台运行容器，确保测试完成后再执行后续步骤：

# 前台启动容器，测试完成后自动退出
docker-compose -f docker-compose.e2e.yml up --abort-on-container-exit
# 测试完成后停止并清理容器
docker-compose -f docker-compose.e2e.yml down

2. 卷映射权限不匹配 #

Bitbucket Pipeline工作区的目录权限与Docker容器内的用户权限不一致，导致Cypress无法写入挂载的本地目录。

解决：

• 在Docker Compose中指定与主机一致的用户ID和组ID：

  services:
    cypress:
      build: 
        context: .
      user: "${UID}:${GID}"
      volumes:
        - ./cypress-reports/screenshots:/cypress/screenshots
        - ./cypress-reports/mochawesome-report:/mochawesome-report
  

• 在Pipeline的script中提前导出UID和GID：

  export UID=$(id -u)
  export GID=$(id -g)
  mkdir -p cypress-reports/screenshots cypress-reports/mochawesome-report
  docker-compose -f docker-compose.e2e.yml up --abort-on-container-exit
  

3. 验证容器内报告输出路径 #

确认Cypress配置文件（cypress.config.js）中设置的报告路径与卷映射的目标路径完全一致：

module.exports = {
  e2e: {
    screenshotsFolder: '/cypress/screenshots',
    reporter: 'mochawesome',
    reporterOptions: {
      reportDir: '/mochawesome-report'
    }
  }
};

4. 添加报告生成验证步骤 #

在Pipeline的script中加入目录检查，确认报告是否生成，便于排查：

# 在容器运行完成后检查文件
ls -la cypress-reports/screenshots
ls -la cypress-reports/mochawesome-report

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