Ruby AASM如何实现模型update状态字段时触发状态转换回调

核心目标是不开启no_direct_assignment配置（避免破坏ActiveAdmin等依赖直接属性赋值的集成），同时拦截状态字段的直接写入操作，自动路由到对应的AASM事件方法执行，保证回调、校验、流转逻辑完全对齐。

首选方案：重写状态字段的setter方法 #

这是侵入性最低、行为最可控的实现方式，直接覆盖AASM状态列的属性写入逻辑：

class Developer < ApplicationRecord
  include AASM

  aasm column: 'state' do
    # 原有状态、事件、回调定义保持不变
    state :interviewing, initial: true
    state :hired
    event :hired do
      transitions from: :interviewing, to: :hired
      after_commit :send_hired_notice # 任意原有回调都能正常触发
    end
  end

  # 重写state属性的写入方法
  def state=(new_state)
    # 状态无变更直接走原生逻辑，避免无意义执行
    return super if new_state.to_s == state.to_s

    # 查找能流转到目标状态的合法事件
    target_event = self.class.aasm.events.find { |evt| evt.transitions_to?(new_state.to_sym) }
    
    if target_event
      # 存在合法事件则调用bang方法，完整走AASM所有逻辑
      public_send(:"#{target_event.name}!")
    else
      # 无合法流转路径时抛出和直接调用非法事件一致的异常
      raise AASM::InvalidTransition.new(
        self, 
        target_event, 
        self.class.aasm.name,
        "无法从当前状态<#{state}>流转到目标状态<#{new_state}>"
      )
    end
  end
end

方案优势 #

• 100%兼容ActiveAdmin等通用组件的直接更新逻辑，不会出现no_direct_assignment开启后表单提交直接报错的问题
• 执行developer.update!(state: :hired)时的流转逻辑、回调触发、事务行为、异常抛出和直接调用developer.hired!完全一致
• 非法状态赋值会被拦截，不会出现脏数据直接写库的问题

注意事项 #

• 如果同一个目标状态对应多个可触发的进入事件（比如不同业务场景下从不同源状态到同一终态走不同事件），不要用自动匹配事件的逻辑，要自行维护映射表指定对应关系，避免触发错误事件
• 如果需要兼容非bang的更新场景（调用update返回布尔值不抛异常），可以调整逻辑判断调用不带!的事件方法，和ActiveRecord的更新行为对齐

备选方案：用更新回调拦截状态变更 #

如果不想重写属性setter，也可以通过模型的before_update回调拦截状态变更：

class Developer < ApplicationRecord
  # 原有AASM定义不变
  before_update :route_state_change_to_aasm_event, if: :state_changed?

  private
  def route_state_change_to_aasm_event
    target_state = state
    # 回退状态变更，改走AASM事件逻辑
    self.state = state_was

    target_event = self.class.aasm.events.find { |evt| evt.transitions_to?(target_state.to_sym) }
    raise AASM::InvalidTransition, "非法状态流转" unless target_event

    public_send(:"#{target_event.name}!")
  end
end

这个方案的缺点是需要先回退待写入的状态值，逻辑链路更绕，且容易和其他更新回调产生执行顺序冲突，优先选择重写setter的方案。

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