You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

升级至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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.05.27 07:30:17