如何避免运行bin/rails test时触发yarn编译及排查相关问题

核心问题原因 #

当你运行bin/rails test不带任何路径参数时，Rails 7.1会默认扫描所有测试类型（包括系统测试）——哪怕你的项目里没有系统测试文件。系统测试依赖前端资产（JS/CSS）的可用状态，因此Rails会触发jsbundling-rails和cssbundling-rails的编译钩子，分别执行esbuild和CSS的yarn编译。

而当你指定具体测试路径（比如bin/rails test test/**/**.rb或bin/rails test test/）时，Rails会直接定位到目标测试文件，跳过测试类型的全局扫描，也就不会触发系统测试相关的资产编译逻辑，测试会直接执行。

测试环境触发编译的配置位置 #

触发逻辑并非在test/test_helper.rb里，而是来自Rails集成的两个核心gem：

• jsbundling-rails和cssbundling-rails会在Rails的测试任务中添加钩子，当检测到测试任务可能涉及系统测试场景时（比如无参数的rails test），自动触发yarn编译。
• 具体的任务定义在这两个gem的源码中，比如jsbundling-rails会在lib/tasks/jsbundling/build.rake里定义编译任务，Rails的测试任务会在特定条件下调用这些任务。
• 另外，Rails核心的railties gem中，test任务的无参数逻辑会加载所有测试框架的依赖，其中系统测试的初始化逻辑会触发资产预编译的前置动作。

自行排查方法 #

• 追踪命令调用栈：运行bin/rails test --trace，查看完整的任务执行流程，找到触发yarn编译的具体任务节点，定位到对应的gem或Rails源码。
• 隔离gem测试：临时在Gemfile中注释掉cssbundling-rails或jsbundling-rails，重新运行bin/rails test，确认是哪个gem的钩子在起作用。
• 查看Rails任务源码：直接查看Rails核心的测试任务定义（比如railties/lib/rails/test_unit/testing.rake），了解无参数test命令的执行逻辑。
• 检查环境配置：查看config/environments/test.rb中的资产相关配置，比如config.assets.compile，不过Rails 7用bundling模式下这个配置影响不大，但可以确认是否有强制编译的设置。

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