企业官网建设流程全解析

• 测试
• 开发工具

导读

在测试数据工厂 factory_bot 中，回调（callback）是构造对象前后执行自定义逻辑的标准机制。本篇文章聚焦一个被许多人忽略却非常实用的写法：在回调中直接使用 Ruby 的Symbol#to_proc（即&:方法名简写），例如after :create, &:confirm!。读完本文，你将掌握这一简写形式的完整用法、它在 factory_bot 源码层面的执行原理（Callback#run 的参数分派逻辑）、适用的回调事件与执行顺序，以及它与传统块写法的边界与注意事项。

背景：Ruby 的Symbol#to_proc是什么

Symbol#to_proc是 Ruby 内置的语法糖：当你把一个 Symbol 用&作为块参数传入时，Ruby 会把它转换成一个 Proc，这个 Proc 收到对象后会把该 Symbol 对应的方法调用在对象身上。也就是说：

users.map(&:name) # 等价于 users.map { |user| user.name }

这条语法与 factory_bot 的属性声明也是兼容的——在 definition_spec.rb 中可以看到用password_confirmation(&:password)声明属性的测试。而本文要讨论的是它在回调中的应用，这一能力在 NEWS.md 中被记录为“Allow use of Symbol#to_proc in callbacks”，即回调中允许使用Symbol#to_proc。

核心用法：after :create, &:confirm!

原文档 symbol-to_proc.md 给出的示例非常直观：假如你的 ActiveRecord 模型有一个confirm!实例方法，希望在工厂创建用户后自动调用它，可以这样写：

# app/models/user.rb class User < ActiveRecord::Base def confirm! # confirm the user account end end # spec/factories.rb FactoryBot.define do factory :user do after :create, &:confirm! end end create(:user) # creates the user and confirms it

当执行create(:user)时，factory_bot 先按:create策略构造并保存User实例，然后触发after :create回调；此时&:confirm!等价于{ |user| user.confirm! }，即对刚创建的实例调用confirm!方法。因此这一行代码让“创建即确认”成为工厂的默认行为，无需再为每个测试手动补一次user.confirm!。

同样的示例也收录在官方入门指南 GETTING_STARTED.md 的### Symbol#to_proc小节，说明这是文档公认的标准用法。

源码原理：Callback#run如何执行&:方法名

要理解&:confirm!为什么能正常工作，需要看回调的核心实现 callback.rb。FactoryBot::Callback在初始化时把回调名转为 Symbol，并在run方法中根据块的arity（参数个数）分派执行：

def run(instance, evaluator) case block.arity when 1, -1, -2 then syntax_runner.instance_exec(instance, &block) when 2 then syntax_runner.instance_exec(instance, evaluator, &block) else syntax_runner.instance_exec(&block) end end

关键点在于：

• &:confirm!转换出的 Proc 本质是接收一个参数的块（arity 为 1），因此命中when 1, -1, -2分支，执行syntax_runner.instance_exec(instance, &block)——把正在构造的实例同时作为 self 上下文和块的第一个参数传入。对Symbol#to_proc而言，Proc 会对传入的参数调用confirm!，于是confirm!被调用在刚构造好的instance上；
• 如果块显式声明两个参数（after(:create) { |instance, evaluator| ... }），则命中when 2分支，额外传入 evaluator，让你能访问 transient 属性等上下文；
• 如果块不接收参数，则走else分支，只切换 self 不传参。

因此，&:方法名简写恰好满足“无参数实例方法”这一最常见的回调诉求，而工厂回调所需的 evaluator 上下文则需要用完整的双参数块来获取（详见 transient-attributes/with-callbacks.md）。

回调块实际运行在 syntax_runner.rb 定义的SyntaxRunner实例上，它include Syntax::Methods，意味着在回调块内部你仍然可以调用FactoryBot的语法方法（如create、build、generate等），这也是 callbacks/symbol-to_proc.md 之外很多回调技巧的基础。

回调事件的完整清单与触发时机

Symbol#to_proc可以套用在任意一种回调事件上。根据 summary.md 的表格，factory_bot 提供的回调事件与触发时机如下：

前六个构成通常所说的六大回调，before(:all)与after(:all)属于跨实例的全局生命周期钩子。以after :create, &:confirm!为例，它命中的是“保存对象之后”这一时机，因而confirm!对已落库的实例生效。

从源码看，definition.rb 会把before :build/after :create这类写法规范化为名为:before_build/:after_create的Callback对象存入回调列表，而DefinitionProxy（definition_proxy.rb）则负责把before、after这两个 DSL 方法委托给@definition，从而让factory块内的回调声明得以生效。

回调的执行顺序与去重

当同一次构造触发了多个同名回调时，执行顺序有明确的层级。根据 callback_order.md，顺序为：全局回调 → 继承（父工厂）回调 → 工厂自身回调 → trait 回调（按声明顺序）。例如：

FactoryBot.define do after(:create) { |user| puts "Global after(:create)" } factory :user do after(:create, &:confirm!) trait :verified do after(:create) { |user| puts "Trait after(:create)" } end end end create(:user, :verified) # 输出顺序： # Global after(:create) #（user 工厂自身的 after :create, &:confirm!） # Trait after(:create)

回调的去重则由 callbacks_observer.rb 负责：它按“实例 object_id + 回调对象 object_id”记录完成状态，保证同一个回调不会对同一个实例重复执行。

测试如何验证这一特性

仓库的验收测试 callbacks_spec.rb 专门覆盖了“callbacks using Symbol#to_proc”场景：定义了一个带confirmed?/confirm!方法的User模型，工厂声明after :build, &:confirm!，随后断言FactoryBot.build(:user)得到的实例be_confirmed。测试同时验证了after与before两种写法均可使用该简写：

describe "callbacks using Symbol#to_proc" do # define_model("User") { def confirmed?; !!@confirmed; end; def confirm!; @confirmed = true; end } FactoryBot.define do factory :user do after :build, &:confirm! end end it "runs the callback correctly" do user = FactoryBot.build(:user) expect(user).to be_confirmed end end

这说明&:方法名并非文档孤例，而是有正式测试保障的稳定行为。

使用注意事项与边界

1. 方法必须是无参的实例方法：&:confirm!会把方法调用在构造出的实例上，方法不应要求额外参数；若需要参数或需要访问 evaluator（如读取 transient 属性），请改用完整块after(:create) { |instance, evaluator| ... }。
2. 方法需真实存在于实例：Symbol#to_proc本质是对对象调用public_send，方法不存在会直接抛NoMethodError，因此只适用于模型确实定义了该方法的场景。
3. 适用于任意策略回调：&:方法名不仅可用于after :create，同样可用于after :build、after :stub等任意回调事件，测试中使用的就是after :build, &:confirm!。
4. 同一模式的扩展用法：类似的&:简写也出现在其他工厂 DSL 位置，例如 create_spec.rb 中to_create(&:persist)用同一语法定制持久化行为，可作为理解该模式在 factory_bot 中通用性的旁证。
5. 语义自文档化：after :create, &:confirm!比after(:create) { |user| user.confirm! }更紧凑，且方法名自带意图，适合在测试数据准备阶段批量声明“创建后自动执行某操作”的默认行为。

延伸阅读

• 回调总览与事件时机
• 回调执行顺序详解
• 默认回调行为
• 全局回调
• 同一事件注册多个回调
• 回调与 transient 属性的配合
• 回调核心实现 Callback#run
• 回调执行与去重 CallbacksObserver
• Symbol#to_proc 回调验收测试

• 测试
• 开发工具