Cypress启动时出现Applitools报错:插件无效、缺失@applitools/eyes-cypress模块
报错核心根因
当前触发的插件加载失败,是两个问题叠加导致的:
- 插件文件
cypress/plugins/index.js中存在require('@applitools/eyes-cypress')的代码,但项目依赖中未安装这个包,直接抛出Cannot find module异常,连带被判定为无效插件文件 - 报错信息中出现了两个不一致的插件查找路径,说明Cypress配置里的
pluginsFile路径存在配置偏差,指向了错误的文件存储位置
分场景修复方案
场景1:项目确实需要使用Applitools做视觉回归测试
按顺序执行以下步骤:
- 确认在项目根目录(即存在
package.json的文件夹层级),安装与Cypress 6.3.0兼容的Applitools依赖:npm install --save-dev @applitools/eyes-cypress@3注意:不要安装最新大版本的eyes-cypress,该版本是适配Cypress 10+以上版本的,和你当前使用的6.3.0不兼容,会触发新的启动报错
- 检查你的插件文件(路径以Cypress配置实际指向的为准),确保Applitools的初始化代码写法正确,不要出现独立require包却不传入module的错误写法:
// 正确初始化写法 require('@applitools/eyes-cypress')(module) module.exports = (on, config) => { // 保留你原有其他插件逻辑 } - 修正
cypress.json(Cypress 6.x版本的配置文件)里的pluginsFile路径,确保和实际存放插件文件的位置一致,避免出现跨用户目录查找文件的偏差 - 完全退出Cypress测试运行器后重新启动
场景2:项目不需要使用Applitools相关能力
两个可选修复方向,按需选择:
- 打开实际被Cypress加载的插件文件,直接删除所有引入
@applitools/eyes-cypress的代码,保留原有插件逻辑即可 - 如果项目完全没有自定义插件的需求,直接在
cypress.json中将pluginsFile配置项设置为false,Cypress会跳过整个插件文件加载流程,不会触发模块查找的异常
常见踩坑提示
- 安装依赖时不要错把包装到
cypress子目录下,Node的模块查找逻辑会优先从项目根目录的node_modules里定位依赖,装错位置还是会报找不到模块的错误 - 如果之前修改过插件文件的扩展名(比如在.js/.ts/.coffee之间切换),修改配置后必须完全关闭Cypress GUI窗口重启,仅刷新页面不会触发插件配置重加载
内容的提问来源于stack exchange,提问作者Aishwarya
相关产品推荐
相关产品推荐

