如何解决Rails项目中前端测试套件在CI上运行过慢的问题？

问题背景 #

项目CI运行测试时速度异常缓慢，部分测试无法在所有机器完成，整体耗时可达数小时。测试用例本身简单、数量有限，仅前端相关测试套件受影响，后端测试无此问题。

通过TestProf分析50个测试样本，核心耗时数据如下：

==================================
  Mode: wall(1000)
  Samples: 479622 (1.44% miss rate)
  GC: 2120 (0.44%)
==================================
     TOTAL    (pct)     SAMPLES    (pct)     FRAME
    420932  (87.8%)      420932  (87.8%)     Kernel#sleep
     37954   (7.9%)       37954   (7.9%)     Thread::Mutex#sleep
      5852   (1.2%)        5852   (1.2%)     PG::Connection#exec
      2436   (0.5%)        2433   (0.5%)     PG::Connection#exec_params
      1406   (0.3%)        1406   (0.3%)     (marking)

已移除所有显式sleep语句，但问题仍未解决。项目环境为Rails 7、Webpacker 5。

排查与解决方向 #

1. 锁定Webpacker编译的隐式等待 #

Webpacker 5在测试环境下的实时编译逻辑可能触发隐式等待：

• 检查config/webpacker.yml，确保测试环境的compile选项设为false，强制使用预编译资产
• 在CI流程中提前执行rails assets:precompile，避免测试时动态编译资产

2. 排查系统测试框架的隐式等待逻辑 #

若使用Capybara等工具做前端测试，框架的隐式等待可能是元凶：

• 检查Capybara的default_max_wait_time配置，避免设置过大的值（默认2秒，若误设为10+秒会大幅增加等待时间）
• 针对测试中使用的find、click等方法，确认目标DOM元素是否能正常渲染，若元素加载失败会触发框架的长时间等待
• 开启Capybara的debug模式，查看测试执行时浏览器的渲染状态，定位是否有前端渲染阻塞

3. 解决线程锁导致的等待 #

Thread::Mutex#sleep占比提示可能存在并发资源竞争：

• 检查测试是否涉及多线程操作（如Webpacker编译线程、测试并行执行），确认是否有未正确释放的锁
• 暂时关闭CI的测试并行执行，观察问题是否缓解，排除资源竞争问题
• 检查项目中是否有自定义的线程同步逻辑，是否存在死锁风险

4. 修复Webpacker与Rails 7的兼容性问题 #

Rails 7默认使用importmaps，Webpacker 5存在潜在兼容问题：

• 升级Webpacker到5.x分支的最新补丁版本，修复已知的兼容bug
• 检查自定义Webpack配置，移除可能导致编译阻塞的插件或复杂逻辑

5. 排查CI环境资源限制 #

CI机器资源不足可能导致进程阻塞：

• 查看CI的资源监控日志，确认测试执行时CPU、内存是否耗尽
• 本地模拟CI的资源限制（如用Docker限制CPU核心数），复现问题并定位瓶颈

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