PaperTrail无法记录关联表软删除的destroy事件，求解决方案

问题描述 #

使用PaperTrail记录系统变更审计日志时，发现作为关联表（join table）的book_genres在软删除操作时，无法触发PaperTrail的destroy事件记录，导致该类操作未被追踪。但其他非关联表（如covers）的create、destroy事件均能正常被PaperTrail记录。

BookGenre关联表模型代码 #

module Book
  class BookGenre < ApplicationRecord
    acts_as_paranoid
    has_paper_trail

    belongs_to :book, inverse_of: :book_genres
    belongs_to :genre

    validates :book, presence: true
    validates :genre, presence: true
  end
end

# == Schema Information
#
# Table name: book_genres
#
#  id            :bigint           not null, primary key
#  deleted_at    :datetime
#  created_at    :datetime         not null
#  updated_at    :datetime         not null
#  genre_id      :integer          not null
#  book_id       :integer          not null
#

该表的变更通过Book控制器的update方法执行，当移除书籍关联的分类时，PaperTrail未向versions表写入任何对应记录。

正常工作的Cover模型代码 #

module Book
  class Cover < ApplicationRecord
    acts_as_paranoid
    has_paper_trail

    belongs_to :book

    validates :book, presence: true
    validates :cover_link, presence: true
  end
end

# == Schema Information
#
# Table name: covers
#
#  id            :bigint           not null, primary key
#  deleted_at    :datetime
#  created_at    :datetime         not null
#  updated_at    :datetime         not null
#  book_id       :integer          not null
#  cover_link    :string           not null 
#

已尝试的操作 #

• 显式指定PaperTrail追踪操作：has_paper_trail :on => [:update, :create, :destroy]
• 安装并配置paper_trail-association_tracking gem
• 将PaperTrail升级至最新版本
• 查阅PaperTrail官方文档未找到对应解决方案

解决方案 #

1. 适配软删除的本质（更新操作） #

acts_as_paranoid的软删除并非真正触发destroy回调，而是执行update操作设置deleted_at字段。需要让PaperTrail捕捉该字段的变更，并手动标记为删除事件：

修改BookGenre模型的PaperTrail配置，添加回调处理软删除：

module Book
  class BookGenre < ApplicationRecord
    acts_as_paranoid
    has_paper_trail only: [:deleted_at], on: [:create, :update, :destroy]

    belongs_to :book, inverse_of: :book_genres
    belongs_to :genre

    validates :book, presence: true
    validates :genre, presence: true

    before_update :log_soft_delete, if: :deleted_at_changed?

    private

    def log_soft_delete
      # 当deleted_at被设置时，手动记录destroy事件
      paper_trail.record_destroy if deleted_at.present?
    end
  end
end

2. 确保关联操作触发模型回调 #

检查Book模型中的关联配置，确保移除关联时触发BookGenre的模型回调：

module Book
  class Book < ApplicationRecord
    has_many :book_genres, inverse_of: :book, dependent: :destroy
    has_many :genres, through: :book_genres
  end
end

这样在通过book.genres = new_genre_list更新关联时，Rails会使用destroy方法移除旧关联记录，确保模型回调被执行。

3. 区分软删除与硬删除（可选） #

如果需要在审计日志中区分软删除和硬删除，可以在版本记录中添加元数据：

def log_soft_delete
  if deleted_at.present?
    paper_trail.record_destroy(metadata: { soft_delete: true })
  end
end

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