本地运行多个Cypress实例出现不可预测错误，该如何解决？

你遇到的这些非确定性错误的核心原因是多Cypress进程共享了全局读写路径，存在资源竞争，你当前的脚本只配置了独立的Cypress服务端口，没处理其他共享资源的隔离问题，具体忽略的点如下：

• 全局缓存/编译产物冲突：Cypress默认会把TypeScript转译结果、自定义命令预加载产物、依赖缓存存放在同一根目录下的.cypress文件夹中，多进程同时读写该目录时会出现文件被截断、写覆盖的问题，直接导致自定义命令找不到、语法错误这类单进程不会出现的异常。
• 浏览器用户数据目录冲突：所有Cypress实例默认会共用同一份浏览器用户数据目录，多无头浏览器实例同时读写该目录的Cookie、本地存储、临时缓存文件时会出现数据污染，导致测试非确定性失败。
• 输出目录写入冲突：默认所有测试的截图、录像、结果报告都会写入同一份输出目录，多进程同时写同一份文件时会出现IO阻塞，触发无理由的超时错误。
• 系统资源限制未调整：单台机器跑超过4个Cypress实例时，会占用大量文件句柄、IPC共享内存、进程数资源，系统默认的ulimit限制通常不足以支撑，会导致进程启动失败、请求超时。

无Docker的优化方案 #

你可以直接修改现有脚本，给每个Cypress实例配置独立的运行目录即可解决绝大多数问题：

1. 每个线程实例执行前，创建专属的缓存、输出、浏览器数据目录
2. 通过环境变量和运行参数给每个实例指定对应目录，示例修改后的运行命令如下：

# 提前创建专属目录
mkdir -p ./cypress-runtime/thread-$i/{cache,user-data,screenshots,videos}
# 运行时指定独立配置
CYPRESS_CACHE_FOLDER=./cypress-runtime/thread-$i/cache \
npx cypress run \
  --spec $specFiles \
  --port $port \
  --dev-port $((40001+$i)) \
  --headless \
  --config \
    screenshotsFolder=./cypress-runtime/thread-$i/screenshots,\
    videosFolder=./cypress-runtime/thread-$i/videos,\
    userDataDir=./cypress-runtime/thread-$i/user-data \
&

3. CI执行前先调整系统资源限制，执行ulimit -n 65536调高文件句柄上限。

如果调整后仍有异常，再考虑使用Docker方案，每个实例跑在独立容器中可以彻底解决资源竞争问题，CI侧只需要增加镜像拉取步骤，复杂度增加非常有限。

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