如何解决Cypress的plugins/index.js插件抛出的ENOENT报错问题

完整报错信息：
插件抛出了错误，请检查插件文件/home/dev2/Desktop/kavitaSeffcon/CypressProject/cypress/plugins/index.js，具体错误信息为：Error: ENOENT: no such file or directory, stat '/initrd.img'

问题根因 #

该错误为Linux环境下Cypress插件运行时触发的异常：插件逻辑中包含无路径限制的文件扫描、属性读取操作，遍历到系统根目录时尝试访问/initrd.img虚拟启动文件，该文件无实际物理路径、普通用户也无访问权限，最终触发文件不存在报错。

可落地解决方案 #

• 排查插件文件的路径遍历逻辑
  打开cypress/plugins/index.js文件，检查所有调用fs.stat、fs.readdir、fs.existsSync等文件操作API的代码，是否存在无终止条件的向上遍历、全目录扫描逻辑。给遍历逻辑添加终止条件，仅扫描项目所属目录，禁止遍历到/根目录。
  示例修正代码：

  // 错误示例：无终止条件的向上遍历逻辑，会一直走到根目录触发报错
  function findConfigFile(currentDir) {
    const configPath = path.join(currentDir, 'custom.config.js')
    if (fs.existsSync(configPath)) return configPath
    return findConfigFile(path.join(currentDir, '..'))
  }
  
  // 修正后：增加终止条件，走到项目根目录或系统根目录就停止遍历
  function findConfigFile(currentDir) {
    const configPath = path.join(currentDir, 'custom.config.js')
    if (fs.existsSync(configPath)) return configPath
    // 检测到根目录或者项目根目录（存在package.json）就终止遍历
    if (currentDir === '/' || fs.existsSync(path.join(currentDir, 'package.json'))) {
      return null
    }
    return findConfigFile(path.join(currentDir, '..'))
  }
  

• 定位冲突的第三方插件
  如果plugins/index.js中仅引入了第三方插件无自定义代码，依次注释插件注册代码后运行测试，定位引发问题的第三方插件，替换为兼容版本或者移除无用插件。
• 添加Cypress全局文件排除规则
  在Cypress配置文件中添加系统级文件的忽略规则，避免Cypress自动扫描到此类文件：

  // Cypress 10+ 版本 cypress.config.js 配置示例
  const { defineConfig } = require('cypress')
  module.exports = defineConfig({
    excludeSpecPattern: ['**/node_modules/**', '/initrd.img', '/vmlinuz'],
    // 其余原有配置保留
  })
  

• 权限验证（仅排查使用）
  临时以sudo权限运行一次Cypress测试，若报错消失即可确认是文件访问权限/路径不存在问题，无需修改系统权限，按前三个方案调整代码即可，禁止长期使用sudo运行Cypress避免项目文件权限污染。

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