Laravel Feature Test插入Metadata数据测试失败排查

你的测试失败本质是混淆了Eloquent模型返回值和HTTP测试响应对象的用法：

• Metadata::create() 是Eloquent模型的批量创建方法，执行成功后返回的是 Metadata 模型实例，不是测试场景下的HTTP响应对象
• assertCreated() 是Laravel测试响应类TestResponse的专属方法，作用是断言HTTP返回状态码为201，模型实例不存在这个方法，调用时会直接抛出方法不存在的致命错误，这是测试失败的首要原因

除了核心的方法调用错误，还有三个高频坑会导致测试失败：

• 批量赋值权限问题：检查Metadata模型的$fillable属性，必须包含metable_id、metable_type、type、key、value字段，否则create操作会触发Mass Assignment异常
• 外键约束问题：迁移里metable_id是无符号大整数，如果开启了外键约束，硬编码metable_id=1但测试库中不存在id为1的File记录，会直接抛出SQL约束错误
• 测试逻辑缺失：原代码没有任何数据库层面的断言，即使create执行成功，也无法验证数据真的正确写入数据表

场景1：测试模型本身的插入逻辑（单元测试范畴） #

如果你的目标是直接验证Metadata模型的写入能力，不需要走HTTP接口，参考以下写法：

// 测试类中要引入RefreshDatabase trait，自动重置测试数据库
use Illuminate\Foundation\Testing\RefreshDatabase;

public function test_insert_unique_data()
{
    // 用工厂生成关联的File记录，避免硬编码ID导致外键错误
    $file = File::factory()->create();

    $metadata = Metadata::create([
        'metable_id' => $file->id,
        'metable_type' => File::class,
        'type' => 'resolution',
        'key' => 'width',
        'value' => 1000,
    ]);

    // 断言返回值是正确的模型实例
    $this->assertInstanceOf(Metadata::class, $metadata);
    // 断言数据真实写入数据库，字段值匹配
    $this->assertDatabaseHas('metadata', [
        'id' => $metadata->id,
        'metable_id' => $file->id,
        'metable_type' => File::class,
        'type' => 'resolution',
        'key' => 'width',
        'value' => 1000,
    ]);
}

场景2：测试元数据插入接口（Feature测试范畴） #

如果你的目标是验证对外提供的HTTP接口的插入逻辑，需要先构造请求拿到响应对象，再调用断言方法：

use Illuminate\Foundation\Testing\RefreshDatabase;

public function test_insert_unique_data_via_api()
{
    $file = File::factory()->create();
    $payload = [
        'metable_id' => $file->id,
        'metable_type' => File::class,
        'type' => 'resolution',
        'key' => 'width',
        'value' => 1000,
    ];

    // 替换成你实际的接口路由，发起请求后拿到TestResponse实例
    $response = $this->postJson('/api/metadata', $payload);

    // 此时才可以调用响应相关的断言方法
    $response->assertCreated()
        ->assertJsonPath('key', 'width')
        ->assertJsonPath('value', 1000);

    // 落库断言
    $this->assertDatabaseHas('metadata', $payload);
}

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