Rails Minitest如何设置Time.now时区实现跨服务器测试通用

问题根源 #

你遇到的输出差异来自Time.now的取值逻辑：该方法会读取运行环境的系统默认时区生成时间对象，仅Stub时间数值未绑定时区时，不同服务器的系统时区不同，最终生成的iso8601字符串后缀就会出现偏移。

可落地的解决方法 #

方案1：Stub时间时强制绑定指定时区 #

Stub Time.now方法时直接返回带固定时区的时间对象，完全不依赖运行环境的系统时区：

• Ruby环境示例代码：

# 固定返回东八区的2021-07-19 01:00:00
stub(Time).now { Time.new(2021, 7, 19, 1, 0, 0, "+08:00") }

• 配置后Time.now().iso8601.to_s的输出会固定为2021-07-19T01:00:00+08:00，任意时区的服务器运行都会得到一致结果。

方案2：断言时统一转UTC时间比对 #

如果业务不需要校验时区后缀，可将输出的时间字符串统一转成UTC时间后再做断言，自动抵消时区差异：

• 示例断言代码：

# 把待测试模块的输出转UTC时间
actual_time = Time.parse(your_module_output).utc
# 期望的UTC时间：东八区1点对应UTC前一天17点
expected_time = Time.new(2021, 7, 18, 17, 0, 0, "+00:00")
assert_equal expected_time, actual_time

方案3：测试进程全局固定时区 #

在测试用例运行前直接修改当前进程的时区配置，覆盖系统默认时区：

• Ruby环境下可直接设置环境变量：
  ENV['TZ'] = 'Asia/Shanghai'
• 该配置仅对当前测试进程生效，不会影响服务器其他业务，所有Time.now调用都会使用指定时区生成时间。

最佳实践：如果业务逻辑不需要依赖运行环境的本地时区，建议直接修改业务代码为Time.now.utc.iso8601.to_s输出UTC时间，从根源上避免时区差异带来的问题，测试时也不需要额外处理时区配置。

内容的提问来源于stack exchange，提问作者James Alain Dantes