升级Ransack至4.0.0后PaperTrail gem功能异常，如何修复？

针对你遇到的升级后PaperTrail历史页面仍报“Ransack需要显式白名单属性”的问题，可按以下步骤排查修复：

1. 修正PaperTrail::Version的Ransack白名单定义 #

确保在config/initializers/paper_trail.rb中正确为PaperTrail::Version类添加完整的白名单方法，覆盖属性和关联规则：

PaperTrail::Version.class_eval do
  # 定义允许Ransack筛选/排序的属性
  def self.ransackable_attributes(auth_object = nil)
    # 列出Version模型核心属性，按需调整
    allowed_attrs = %w(id item_type item_id event whodunnit created_at object object_changes)
    # 追加Ransack内置ransacker的键，避免遗漏系统默认筛选器
    allowed_attrs + _ransackers.keys
  end

  # 定义允许Ransack关联筛选的关联名（无关联需求则返回空数组）
  def self.ransackable_associations(auth_object = nil)
    []
    # 若需关联筛选目标模型，可改为%w(item)，但需确保item关联已正确配置
  end
end

2. 检查ActiveAdmin的Version页面配置 #

打开app/admin/version.rb（或你注册PaperTrail::Version的Admin文件），确保所有filter和sortable用到的属性都在上述白名单内：

ActiveAdmin.register PaperTrail::Version do
  index do
    selectable_column
    column :item_type
    column :item_id
    column :event
    column :whodunnit
    column :created_at, sortable: true # 确保created_at已加入白名单
    actions
  end

  filter :item_type
  filter :item_id
  filter :event
  filter :whodunnit
  filter :created_at
end

若存在未在白名单中的属性筛选项，需移除该筛选或把属性添加到白名单。

3. 检查Ransack全局配置 #

打开config/initializers/ransack.rb，确认是否开启了严格模式：

Ransack.configure do |config|
  # 若开启strict_search，必须保证所有用到的筛选、排序属性都在白名单中
  config.strict_search = true
end

如果开启了严格模式，需逐一核对ActiveAdmin页面的所有属性使用场景，确保无遗漏。

4. 强制重启Rails服务器 #

修改initializer后必须重启服务器，否则新的白名单定义不会加载生效。

5. 排查类定义覆盖问题 #

若上述步骤无效，检查是否有其他代码（如其他initializer、模型扩展文件）重新定义了PaperTrail::Version类，导致你添加的白名单方法被覆盖。可在Rails控制台执行PaperTrail::Version.method_defined?(:ransackable_attributes)验证方法是否存在。

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