为何rspec启动后挂起无响应？已稳定运行的旧项目突然无法执行测试

第一步：定位挂起的具体位置 #

• 执行带调试参数的命令：rspec --debug，打印完整执行栈信息，直接定位挂起点对应的代码位置
• 若debug参数无额外输出，执行rspec --format documentation，逐行打印测试用例执行记录，找到最后输出的用例描述，挂起点就落在该用例或其关联的前置钩子中

第二步：排查项目环境与依赖问题 #

• 清除依赖缓存重装：执行rm -rf vendor/bundle && bundle install，排除本地gem缓存损坏导致的异常
• 核对rspec相关依赖版本：执行bundle list | grep rspec，对比项目历史正常运行时的rspec-core、rspec-rails等组件版本，若存在被动升级，在Gemfile中锁定历史可用版本后重新安装
• 检查rspec全局配置：核对spec/spec_helper.rb、spec/rails_helper.rb的近期变更，重点排查新增的全局before/around钩子、第三方测试插件（如测试覆盖率工具、数据库清理组件、stub工具）的配置，临时注释新增配置后重试

第三步：排查阻塞类逻辑 #

• 数据库阻塞排查：Rails项目可先执行bundle exec rake db:test:prepare重置测试库，手动终止测试库的所有活跃连接后重试
• 外部请求阻塞排查：检查挂起的测试是否存在未mock的外部API、本地中间件（Redis、ES、消息队列等）调用，对应服务未启动、权限变更都会导致进程无限等待响应，可开启全局外部请求拦截（如添加WebMock.disable_net_connect!配置）后重试
• 死锁排查：如果测试涉及多线程/多进程逻辑，或存在事务嵌套配置错误，可临时将配置项use_transactional_fixtures改为false后重试，验证是否为事务死锁导致的挂起

第四步：缩小范围复现验证 #

• 单独执行单个测试文件：rspec spec/[对应测试文件路径]，如果单个文件可正常执行，逐步扩大执行范围，定位到导致全局挂起的特定测试用例
• 切换到项目历史正常运行的Ruby小版本，排除Ruby版本兼容问题

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