Ruby Minitest中puts()输出时有时无的原因及解决

环境配置 #

• 系统：Ubuntu 22.04.2
• Ruby：3.2.3
• Minitest：4.25.4
• Rake：13.2.1
• 测试执行命令：bundle exec rake test $@
• Rakefile规则：匹配ut/ut_*.rb测试文件

问题情况 #

所有测试用例运行正常，但调试输出总是时有时无——不管是直接用puts()，还是用内部已做puts+$stdout.flush的自定义日志工具$svc.log.line，甚至特意手动加$stdout.flush/$stderr.flush都没用。哪怕是写在after_setup里的调试代码，重复跑同一份代码，输出也时有时无。

排查与根因 #

一开始怀疑是Minitest或Rake的输出缓存问题，试了各种刷新手段都没解决。最终发现问题不在测试框架本身，而是自定义日志单例的verbosity属性未在测试间重置：

• Minitest默认随机执行测试顺序
• 日志模块的测试用例会修改这个verbosity属性（比如设为静默级别）
• 若日志测试先执行，后续其他测试的日志输出会被修改后的verbosity限制；若日志测试后执行，前面的测试不受影响。正是这种随机的执行顺序，导致输出时有时无。

解决办法 #

在日志模块的测试用例中添加属性重置逻辑，确保每个测试前后日志级别都能回归初始状态：

• 在setup方法中保存verbosity的原始值
• 在teardown方法中将verbosity恢复为原始值
• 也可以在每个修改过verbosity的测试用例结尾直接重置为默认值

示例代码：

class LogTest < Minitest::Test
  def setup
    # 保存原始日志级别
    @original_verbosity = $svc.log.verbosity
  end

  def teardown
    # 测试结束后恢复原始级别
    $svc.log.verbosity = @original_verbosity
  end

  def test_log_silent_mode
    $svc.log.verbosity = :silent
    # 测试逻辑...
  end
end

这样无论测试顺序如何随机，每个测试都能在独立的日志级别环境下运行，不会干扰其他测试的输出。

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