Rails 全局引入Audited模块 调用audited方法报NoMethodError

• 类方法定义语法不符合Concern约定：ActiveSupport::Concern注入类方法的约定容器是module ClassMethods，代码中写成def ClassMethods，相当于在模块内部定义了一个同名实例方法，audited方法根本没有进入混入类的类方法作用域，直接导致方法找不到的报错。
• 模块加载时序错位：在模块定义文件内直接通过::ActiveRecord::Base.send(:include, Audited)做的顶层混入，在Rails开发模式懒加载机制下，业务模型的加载时机早于Audited模块本身的加载流程。首次触发模型请求时，Thing类先被加载执行，此时父类尚未混入Audited模块，自然找不到audited类方法；报错触发Rails自动加载机制完成Audited模块混入后，后续请求不再报错，但首次加载时中断的类定义逻辑未完整执行，审计功能自然失效。
• class_attribute定义位置错误：将class_attribute :audited_options写在audited类方法内部，每次调用audited都会重复重定义属性，且未调用audited方法的模型类不会生成该属性，实例方法读取时会直接抛出属性不存在的错误。

1. 重写Audited模块代码 #

module Audited
  extend ActiveSupport::Concern

  # 模块被混入时立即执行，给所有继承类定义通用属性
  included do
    # 为所有AR类默认提供审计配置属性，默认值为空哈希
    class_attribute :audited_options, instance_accessor: false, default: {}
  end

  # 正确的类方法容器，使用module而非def定义
  module ClassMethods
    def audited(options = {})
      # 给当前模型类赋值对应的审计配置
      self.audited_options = options
      # 挂载save回调到模型
      after_save :log_audit_change
    end
  end

  # 实例级别的审计回调方法
  def log_audit_change
    puts "被审计的变更字段：#{changed_attributes.keys.inspect}"
    puts "当前模型的审计规则：#{audited_options.inspect}"
  end
end

2. 修正模块加载时机 #

不要在Audited模块的定义文件里直接手动混入ActiveRecord::Base，把混入逻辑移到Rails初始化流程中，确保模块加载时机早于所有模型类的加载：
在config/initializers/目录下新建audited_concern.rb文件，写入：

# 初始化阶段先完成模块混入，再加载所有业务模型
ActiveRecord::Base.include Audited

完成上述修改并重启服务后，模型类代码Thing < ApplicationRecord; audited only: :name; end即可正常工作：

• 首次加载不会触发undefined method 'audited'的报错
• 每次Thing实例保存后，会自动打印出变更字段、对应配置的审计规则
• 所有继承ApplicationRecord的模型类都可以直接调用audited类方法，和原生audited gem的使用体验完全一致

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