testing

Elixir 测试参考

Ash 项目：使用 DataCase 和 Ash.Test 辅助工具；通过域代码接口测试操作，而不是直接调用 Repo。请参阅 ash-framework 技能。

Elixir 测试模式速查。

铁律——绝不可违反

1. 默认启用异步——除非测试会修改全局状态，否则使用 async: true
2. Sandbox 隔离——所有数据库测试都使用 Ecto.Adapters.SQL.Sandbox
3. 只在边界处模拟——绝不模拟数据库、内部模块或标准库
4. 行为作为契约——所有模拟都必须实现已定义的 @callback 行为
5. 默认构建——在工厂中使用 build/2；只有需要数据库时才使用 insert/2
6. 禁止 PROCESS.SLEEP——异步操作使用带超时的 assert_receive
7. VERIFY_ON_EXIT!——在 Mox 测试设置中始终调用
8. 工厂匹配架构必填字段——工厂定义必须包含架构变更集中所有 validate_required 字段。缺少字段会导致一连串测试失败

快速决策

使用哪种测试用例？

测试内容	使用
控制器/API	use MyAppWeb.ConnCase
上下文/架构	use MyApp.DataCase
LiveView	use MyAppWeb.ConnCase + import Phoenix.LiveViewTest
纯逻辑	use ExUnit.Case, async: true

何时使用 async: true？

• ✅ 纯函数，无共享状态
• ✅ 使用 Sandbox 的数据库测试（PostgreSQL）
• ❌ 修改 Application.put_env 的测试
• ❌ 使用 Mox 全局模式的测试

是否要模拟？

• ✅ 模拟：外部 API、邮件服务、文件存储
• ❌ 不要模拟：数据库、内部模块、标准库

使用 build() 还是 insert()？

• 默认使用 build() 以提升速度
• 只有需要数据库 ID、约束或持久化关联时才使用 insert()

快速模式

# Setup chain
setup [:create_user, :authenticate]

# Pattern matching assertion
assert {:ok, %User{name: name}} = create_user(attrs)

# Async message assertion
assert_receive {:user_created, _}, 5000

# Mox setup
setup :verify_on_exit!
expect(MockAPI, :call, fn _ -> {:ok, "data"} end)

# LiveView async
html = render_async(view)  # MUST call for assign_async

常见反模式

错误	正确
Process.sleep(100)	assert_receive {:done, _}, 5000
在工厂中使用 insert(:user)	在工厂中使用 build(:user)
使用 set_mox_global() 时设置 async: true	async: false
模拟内部模块	通过公共 API 测试

参考资料

如需了解详细模式，请参阅：

• ${CLAUDE_SKILL_DIR}/references/exunit-patterns.md - 设置、断言、标签
• ${CLAUDE_SKILL_DIR}/references/mox-patterns.md - 行为、expect/stub、异步
• ${CLAUDE_SKILL_DIR}/references/liveview-testing.md - 表单、异步、上传
• ${CLAUDE_SKILL_DIR}/references/factory-patterns.md - ExMachina、序列、特征