升级至Rails 5.2.0后无法指定测试目录的问题求助
这个问题是Rails 5.2版本对测试命令的默认行为做了针对性调整导致的,核心变化是系统测试与普通测试(模型、策略、服务等)的运行逻辑被拆分了,具体原因和解决方法如下:
为什么会出现这个问题?
在Rails 5.1及更早版本中,rails test命令会扫描所有test/**/*_test.rb文件并运行,不管文件位于哪个子目录。但到了5.2版本,Rails官方考虑到系统测试通常依赖浏览器驱动、运行速度较慢,于是对测试命令做了拆分:
- 默认情况下,
rails test仅运行非系统测试(即排除test/system目录下的测试文件) - 系统测试需要通过专门的
rails test:system命令来触发
当你执行rails test test/system时,Rails的测试运行器会先遵循默认规则排除test/system目录的文件,导致找不到符合条件的测试用例,最终 fallback 到运行所有非系统测试——这就是你看到的“跑了其他测试而非系统测试”的原因。
同样,如果你执行rails test test/policies或rails test test/models却跑了所有非系统测试,大概率是因为升级后没有同步适配Rails 5.2的测试匹配逻辑,或者测试文件的命名/目录结构出现了不兼容的情况。
如何解决?
根据你的需求,有几种不同的处理方式:
1. 按Rails 5.2的规范运行测试
遵循新版本的设计,用对应命令运行不同类型的测试:
- 运行所有系统测试:
rails test:system - 运行指定目录的系统测试:
rails test:system test/system/comment_test.rb(或直接指定目录rails test:system test/system) - 运行所有非系统测试(模型、策略等):
rails test - 运行指定目录的非系统测试:
rails test test/models(确保测试文件都是*_test.rb命名,Rails 5.2默认只识别这个后缀的测试文件) - 运行所有测试(系统+非系统):
rails test:all
2. 统一恢复Rails 5.1的测试行为
如果你更习惯旧版本的统一运行逻辑,可以修改项目的Rakefile,重新定义测试任务的文件匹配规则:
# 在Rakefile中添加以下内容,覆盖默认的test任务行为 Rails::TestTask.new("test" => "test:prepare") do |t| t.pattern = "test/**/*_test.rb" # 扫描所有test目录下的_test.rb文件 end # 可选:重新定义test:all任务(如果需要) Rails::TestTask.new("test:all" => "test:prepare") do |t| t.pattern = "test/**/*_test.rb" end
修改后,rails test就会像5.1版本一样运行所有测试文件,包括系统测试。
3. 适配系统测试文件命名规范
Rails 5.2开始,脚手架生成的系统测试文件默认命名为*_system_test.rb(比如comment_system_test.rb),而非旧版本的*_test.rb。如果你想完全适配新版本的规范,可以批量重命名test/system目录下的测试文件,这样rails test:system命令会自动识别这些文件,无需额外配置。
验证复现问题的原因
你用rails new test_app创建的演示应用默认是Rails 5.2+版本,脚手架生成的系统测试文件是user_system_test.rb而非user_test.rb。此时执行rails test test/system,Rails会默认排除这个目录的文件,所以不会运行任何测试(而非跑其他测试)——这和你描述的升级后的问题本质一致,都是因为默认规则排除了系统测试目录。
内容的提问来源于stack exchange,提问作者Neil

