Rails应用日期转换报TypeError: nil can't be coerced into Integer错误

问题原因 #

这个报错的核心原因是Web运行环境下的周起始日全局配置Date.beginning_of_week被赋值为nil，ActiveSupport的days_to_week_start方法内部需要对周起始日对应的整数做减法运算，nil参与数值运算就会抛出TypeError: nil can't be coerced into Integer错误。
Rails控制台和Web环境运行结果不一致，是因为两者的配置加载逻辑有差异：控制台启动时会自动用默认值补全缺失的配置项，而Web请求上下文如果被初始化脚本、中间件、业务代码在运行时修改了全局配置，就会触发异常。

排查步骤 #

1. 直接在报错的Web控制台执行Date.beginning_of_week，确认返回值是否为nil
2. 检查项目config/initializers目录下的初始化脚本、以及涉及日期配置的自定义代码，是否有条件判断错误导致beginning_of_week被设为nil的逻辑

修复方案 #

方案1：全局固定周起始配置 #

在config/application.rb中添加全局配置，明确指定周起始日：

config.beginning_of_week = :monday
# 可根据业务需求替换为 :sunday/:saturday 等合法值

方案2：调用方法时显式指定周起始日 #

如果不同业务场景周起始日规则不同，可以在调用beginning_of_week时直接传参，绕开有问题的全局配置：

d.beginning_of_week(:monday)
# 同理 next_week 也可以传参：d.next_week(:monday)

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