本文详解如何在 Laravel 9.x 中对 Eloquent 关系方法（如 belongsTo）进行真正的单元测试——不连接数据库、不加载框架服务、仅验证关系定义本身的返回值与行为，满足 100% 覆盖率合规要求。
本文详解如何在 laravel 9.x 中对 eloquent 关系方法（如 `belongsto`）进行真正的单元测试——不连接数据库、不加载框架服务、仅验证关系定义本身的返回值与行为，满足 100% 覆盖率合规要求。
在高度合规场景（如金融、医疗类项目）中，“100% 单元测试覆盖率”常作为硬性交付指标。但需明确一个关键前提：真正的单元测试（Unit Test）必须隔离外部依赖——这意味着不能访问数据库、不触发查询、不依赖模型实际持久化状态。因此，测试 Product::user() 这类关系方法时，目标不是验证“是否能查到用户”，而是验证：
- 该方法是否按预期返回 BelongsTo 实例；
- 其配置参数（如关联模型、外键、本地键）是否正确；
- 它是否可被链式调用（如 ->where(...)->first()），即接口契约是否成立。
✅ 正确做法：直接调用关系方法，断言其返回对象类型与基础属性，不调用 ->get() 或 ->exists() 等触发查询的方法（后者属于集成/功能测试范畴）。
以下是一个符合 PHPUnit 单元测试规范、零数据库交互、完全可离线运行的示例：
<?php namespace Tests\Unit;
use App\Models\Product;
use App\Models\User;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
use Tests\TestCase;
class ProductRelationshipTest extends TestCase
{
/** @test */
public function user_relation_returns_belongs_to_instance()
{
// Arrange: 创建一个未保存的 Product 实例（无需数据库）
$product = new Product();
// Act: 调用关系方法（仅构造关系实例，不执行 SQL）
$relation = $product->user();
// Assert: 验证返回类型及核心配置
$this->assertInstanceOf(BelongsTo::class, $relation);
$this->assertSame(User::class, $relation->getRelated()->getModel());
$this->assertSame('user_id', $relation->getForeignKeyName());
$this->assertSame('id', $relation->getOwnerKeyName());
}
}
⚠️ 注意事项：
- 禁止使用 factory()->create() 或 ->save()：这些操作会写入数据库或触发 Eloquent 生命周期，违背单元测试隔离原则。上文答案中 Product::factory()->for(...)->create() 属于功能测试（Feature Test）写法，它依赖 RefreshDatabase 和真实迁移，不适用于此处定义的「纯单元测试」。
- ->exists() 是陷阱：$product->user()->exists() 会尝试执行 SELECT EXISTS(...) 查询，强制建立数据库连接，导致测试失败或超时——这已脱离单元测试范畴。
- Mock 不是必需项：Eloquent 关系方法本身是确定性函数（返回新 Relation 对象），无需 mock；mock 反而增加复杂度并掩盖真实契约。
-
覆盖率达标的技巧：若某关系方法含条件逻辑（如 return $this->belongsTo(...)->when($this->isPremium(), ...)），则需补充分支覆盖用例，例如：
public function test_user_relation_includes_premium_constraint_when_applicable() { $product = new Product(['is_premium' => true]); $relation = $product->user(); $this->assertTrue(method_exists($relation, 'when')); }
总结：Laravel 关系方法的纯单元测试，本质是验证其声明契约——返回正确的 Relation 类型、绑定正确的模型与键名。它轻量、快速、稳定，是达成高覆盖率且保持测试质量的基石。将数据读写逻辑留给 FeatureTest 或 TestCase 配合 RefreshDatabase，才能实现分层清晰、各司其职的可靠测试体系。
