Cypress GitHub Actions构建失败：出现"Cannot find module"错误

开发者阿泽

2026-7-7

解决GitHub Actions中Cypress构建找不到rollup.config.js的问题

排查与修复方案

确认配置文件是否提交到仓库
本地能运行但CI环境找不到文件，大概率是rollup.config.js没被纳入版本控制。检查.gitignore文件，若存在忽略该文件的规则，删除后执行以下命令提交：
```
git add rollup.config.js
git commit -m "提交rollup配置文件到仓库"
git push
```
检查工作流的目录上下文
错误路径显示为/home/runner/work/CucumberE2E/CucumberE2E/，可能工作流的工作目录设置异常。如果项目根目录就是仓库根目录，无需额外配置；若存在子目录，需在Cypress Action步骤中指定working-directory参数：
```
- name: 运行Cypress测试
  uses: cypress-io/github-action@v6
  with:
    working-directory: ./你的子目录路径
    build: npm run build
```
强制清理并重新安装依赖
CI环境的依赖缓存可能导致异常，在工作流中添加清理步骤：
```
- name: 安装依赖
  run: |
    rm -rf node_modules package-lock.json
    npm install
```
修正rollup配置的引用路径
检查package.json中的build脚本，确保使用相对路径引用配置文件，避免绝对路径：
```
{
  "scripts": {
    "build": "rollup --config ./rollup.config.js"
  }
}
```
调整rollup版本适配Cypress
若存在版本兼容性问题，在package.json中锁定稳定版本的rollup：
```
{
  "devDependencies": {
    "rollup": "^2.79.1"
  }
}
```
重新安装依赖后提交变更。