Rails 6.1中counter cache更新时after_update回调未触发怎么办

核心原因 #

Rails 内置的 counter_cache 功能底层调用的是update_counters方法，该方法直接执行SQL更新数据库字段，不会实例化对应模型对象，也不会触发常规的after_update等实例回调，这就是你直接更新其他字段能触发广播、counter更新时无法触发的核心原因。

可用解决方案 #

方案一：使用Rails 6.1+ 专属的after_update_counter回调（最推荐，适配你当前的6.1.4.1版本） #

这个回调是Rails 6.1专门为counter_cache更新场景新增的，只会在指定的counter字段更新时触发，不会影响其他逻辑，也不会附带额外的字段更新。
示例代码（假设你有Post主模型，Comment关联模型，counter字段为comments_count）：

class Post < ApplicationRecord
  has_many :comments
  # 注册counter更新回调，指定要监听的counter字段，多字段可传数组
  after_update_counter :broadcast_counter_change, on: :comments_count
  # 你原来的after_update可以保留，处理其他字段更新的广播
  after_update :broadcast_normal_change

  private
  def broadcast_counter_change
    # 这里写counter更新对应的广播逻辑
    ActionCable.server.broadcast "post_#{id}_channel", { comments_count: comments_count }
  end

  def broadcast_normal_change
    # 原有其他字段更新的广播逻辑
  end
end

方案二：在关联侧模型绑定回调 #

如果你需要更灵活的控制逻辑，也可以在counter对应的从属模型中加回调，手动触发主模型的广播逻辑：

class Comment < ApplicationRecord
  belongs_to :post, counter_cache: true
  # 新增创建、销毁后的回调，注意用after_commit避免事务未提交导致的数据不一致
  after_commit :trigger_post_counter_broadcast, on: [:create, :destroy]

  private
  def trigger_post_counter_broadcast
    post.broadcast_counter_change
  end
end

方案三：给关联添加touch: true（适合接受updated_at同步更新的场景） #

如果你的业务允许counter更新时同步修改主模型的updated_at字段，可以直接在belongs_to配置中加touch: true，这时候counter更新时会触发主模型的全量更新回调，包括你原来写的after_update，不需要额外修改主模型代码：

class Comment < ApplicationRecord
  belongs_to :post, counter_cache: true, touch: true
end

注意该方案存在副作用：每次counter更新都会修改主模型的updated_at字段，如非业务需要不推荐使用。

注意事项 #

• 所有涉及跨模型的回调操作，优先使用after_commit系列回调，避免事务回滚导致的广播数据不一致问题
• 建议把广播逻辑抽成独立的公共方法，避免常规更新和counter更新场景下重复写代码
• 不要修改Rails内置的counter_cache底层实现，避免后续版本升级出现兼容性问题

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