Rails 5中全局注册自定义Liquid过滤器失败问题排查

这个问题的核心原因是Rails 5默认不会自动加载lib目录下的文件，导致你的DatetimeFilters模块根本没被加载，过滤器自然无法注册生效。下面是一步步的解决方法：

1. 配置Rails自动加载lib目录 #

首先修改config/application.rb，添加对lib目录的自动加载配置：

# config/application.rb
module YourAppName
  class Application < Rails::Application
    # 其他配置...
    # 添加这一行，让Rails自动加载lib目录下的文件
    config.paths.add 'lib', eager_load: true, autoload: true
  end
end

注：eager_load: true确保生产环境下lib文件会被预加载，autoload: true保证开发环境下按需加载，符合Rails的加载机制。

2. 修正文件名与模块名的命名约定 #

Rails的自动加载依赖蛇形文件名对应驼峰模块名的约定：

• 你的模块是DatetimeFilters（驼峰），对应的文件名应该是datetime_filters.rb，而不是liquid_filters.rb。
• 把lib/liquid_filters.rb重命名为lib/datetime_filters.rb，内容保持不变：

# lib/datetime_filters.rb
module DatetimeFilters
  def previous_business_day(datetime)
    Time.previous_business_day(datetime)
  end
end

3. 把过滤器注册移到初始化文件 #

不推荐在lib文件里直接注册过滤器，更好的做法是创建专门的初始化文件来处理：

# config/initializers/liquid_filters.rb
Liquid::Template.register_filter(DatetimeFilters)

因为初始化文件会在Rails启动时自动执行，此时DatetimeFilters已经被自动加载，注册操作能确保生效。

4. 重启服务器并测试 #

修改完application.rb后，必须重启Rails服务器才能让配置生效。之后再运行你控制器里的代码：

# app/controllers/my_controller.rb
template = Liquid::Template.parse('{{ datetime | previous_business_day }}')
result = template.render({'datetime' => Time.parse('2018-01-21 00:00:00 +0100')})

此时应该能得到预期的2018-01-19 00:00:00 +0100结果。

额外检查点 #

如果还是有问题，确认Time.previous_business_day方法确实存在且能正常工作——如果这个方法本身未定义，即使过滤器注册成功也会出错，但你的情况是输出原变量，所以大概率是加载问题导致的过滤器未注册。

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