Rails项目本地运行rspec占满CPU无法完成，版本与同事一致如何排查？

依赖排查清单 #

测试链路核心依赖 #

• rspec相关包：确认rspec-core、rspec-rails版本和Gemfile.lock完全一致，优先用bundle exec rspec命令而非全局rspec执行测试，避免调用到本地缓存的不匹配版本。
• spring预加载器：这是最常见的Rails测试启动卡死诱因，先执行spring stop终止现有进程，再执行测试验证。如果问题消失，可通过DISABLE_SPRING=1 bundle exec rspec 测试路径临时禁用，或回退spring版本到与同事一致的版本。
• 工厂依赖：如果测试用到factory_bot/factory_girl，版本不匹配会导致数据生成逻辑死循环，确认版本对齐后可执行gem pristine factory_bot factory_bot_rails重置本地gem。
• 覆盖率工具：simplecov低于0.21.0的版本在MacOS 11+上存在文件扫描死循环的已知问题，确认版本与同事一致，必要时升级或临时注释覆盖率启动代码验证。

系统依赖与间接关联gem #

• nokogiri：执行gem pristine nokogiri重新编译本地安装的nokogiri，其依赖的libxml2/libxslt系统库版本差异会导致解析逻辑卡死。
• openssl：如果本地openssl版本与Ruby编译时依赖的版本不匹配，会导致加密逻辑死锁，用版本管理工具安装的Ruby可尝试重新编译对应版本：rbenv install 2.5.6 -f（rbenv环境）或rvm reinstall 2.5.6（rvm环境）。
• watchman：如果项目开启了文件监听，watchman版本差异会导致rspec启动阶段重复扫描文件占满CPU，执行brew list --versions watchman确认版本与同事对齐，版本偏差大可降级到对应版本。

快速定位技巧 #

执行bundle exec rspec --backtrace 测试路径打印完整启动调用栈，可直接看到卡在哪一步的依赖调用，精准定位问题包。

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