ActiveRecord::Concern重构Filterable模块时模型常量访问问题

原有的Filterable模块通过硬编码方式为模型生成查询Scope，随着属性增多模块体积膨胀，且不同模型无法按需定义可过滤属性。重构后尝试将FILTER_ATTRIBUTES常量移至各模型类中，但调用Article.filter_eq_weight(0.5)时触发错误：

NameError: uninitialized constant #Class:0x000055655ed90f80::FILTER_ATTRIBUTES
Did you mean?  Article::FILTER_ATTRIBUTES

方案1：正确访问模型常量并安全生成Scope #

问题根源在于原重构代码中class_eval的字符串拼接会导致上下文混淆，改用define_singleton_method可以直接绑定模型类上下文，同时确保正确读取模型中的FILTER_ATTRIBUTES常量：

module Filterable
  extend ActiveSupport::Concern

  included do |base|
    # 强制要求模型定义可过滤属性常量，避免遗漏配置
    unless base.const_defined?(:FILTER_ATTRIBUTES)
      raise NotImplementedError, "#{base.name}必须定义FILTER_ATTRIBUTES常量才能使用Filterable模块"
    end

    # 遍历模型定义的可过滤属性，生成相等匹配的Scope
    base.const_get(:FILTER_ATTRIBUTES).each do |filter|
      define_singleton_method("filter_eq_#{filter}") do |value|
        where(filter => value)
      end

      # 针对数值/日期类型属性，扩展生成比较操作的Scope（可按需调整判断逻辑）
      if [:weight, :created_at].include?(filter.to_sym)
        define_singleton_method("filter_lt_#{filter}") do |value|
          where("#{filter} < ?", value)
        end
        define_singleton_method("filter_lte_#{filter}") do |value|
          where("#{filter} <= ?", value)
        end
        define_singleton_method("filter_gt_#{filter}") do |value|
          where("#{filter} > ?", value)
        end
        define_singleton_method("filter_gte_#{filter}") do |value|
          where("#{filter} >= ?", value)
        end
      end
    end
  end
end

模型类中的配置示例：

class Article < ApplicationRecord
  include Filterable
  # 按需定义当前模型支持过滤的属性
  FILTER_ATTRIBUTES = ['reference', 'description', 'weight', 'created_at']
end

方案2：类方法配置（更灵活的替代方案） #

如果不想使用常量，可通过类方法动态配置可过滤属性，代码可读性和灵活性更高：

module Filterable
  extend ActiveSupport::Concern

  class_methods do
    # 接收可变参数，定义当前模型的可过滤属性
    def filterable_attributes(*attrs)
      @filterable_attributes = attrs.map(&:to_s)
      generate_filter_scopes
    end

    private

    def generate_filter_scopes
      (@filterable_attributes || []).each do |filter|
        define_singleton_method("filter_eq_#{filter}") do |value|
          where(filter => value)
        end

        # 同样扩展比较操作的Scope
        if [:weight, :created_at].include?(filter.to_sym)
          define_singleton_method("filter_lt_#{filter}") do |value|
            where("#{filter} < ?", value)
          end
          # 省略lte/gt/gte的定义，逻辑同方案1
        end
      end
    end
  end
end

模型类中的配置示例：

class Article < ApplicationRecord
  include Filterable
  # 直接通过类方法指定可过滤属性
  filterable_attributes :reference, :description, :weight, :created_at
end

• 用define_singleton_method替代字符串拼接的class_eval，既避免了上下文混淆问题，也提升了代码安全性（防止注入风险）。
• 两种方案都实现了"不同模型按需定义可过滤属性"的目标，可根据团队编码习惯选择：常量方式更直观，类方法配置更灵活。

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