You need to enable JavaScript to run this app. Cypress启动时出现Applitools报错:插件无效、缺失@applitools/eyes-cypress模块
优惠活动
大模型
产品
解决方案
定价
更多

Cypress启动时出现Applitools报错:插件无效、缺失@applitools/eyes-cypress模块

报错核心根因

当前触发的插件加载失败,是两个问题叠加导致的:

  1. 插件文件cypress/plugins/index.js中存在require('@applitools/eyes-cypress')的代码,但项目依赖中未安装这个包,直接抛出Cannot find module异常,连带被判定为无效插件文件
  2. 报错信息中出现了两个不一致的插件查找路径,说明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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.02 16:36:04