Docker运行Cypress报错：无法解析cypress-iframe模块

1. 确认依赖已安装并更新package.json #

先检查本地项目的package.json是否包含cypress-iframe依赖。如果没有，执行以下命令安装并保存到开发依赖：

npm install cypress-iframe --save-dev

使用yarn的话：

yarn add cypress-iframe --dev

2. 检查Docker构建/运行逻辑 #

如果是通过Dockerfile构建镜像，必须在镜像构建阶段执行依赖安装命令，确保依赖被打包到镜像内：

# 示例Dockerfile片段
FROM cypress/base:18
WORKDIR /e2e
# 先拷贝package文件，利用Docker缓存优化构建速度
COPY package*.json ./
RUN npm install
# 再拷贝项目代码
COPY . .
# 执行Cypress运行命令
CMD ["npx", "cypress", "run"]

如果直接用docker run挂载本地目录运行，需确保本地已执行npm install生成完整的node_modules，且挂载路径正确。注意：若本地是Windows系统，直接挂载的node_modules可能和容器内Linux环境不兼容，这种情况建议在容器内重新安装依赖，或改用Dockerfile构建镜像。示例命令：

docker run -v $(pwd):/e2e cypress/included:13.6.0

3. 验证模块导入语句 #

检查cypress/support/commands.js中的导入代码是否正确，无拼写错误：

// 两种导入方式均可
import 'cypress-iframe'
// 或者
require('cypress-iframe')

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