单元测试中向数据库写入模拟数据失败问题咨询

写入失败常见原因 #

• 语法错误：你提供的DB插入代码缺少闭合括号，会直接导致代码运行失败，正确写法为：

DB::table('users')->insert([
    [
        'name' => 'test',
    ]
]);

• 批量赋值拦截：使用Factory写入时，需要确保User模型的$fillable属性已经将name字段加入允许批量赋值的列表，否则Laravel的批量赋值保护机制会直接拦截写入操作。
• 测试特性自动回滚：Laravel单元测试常用的RefreshDatabase、DatabaseTransactions特性会在测试执行完成后自动回滚所有数据库操作，写入的数据不会持久化保留，不是没有写入成功，是测试跑完就自动清理了，不要直接在外部数据库查询验证写入结果。
• 测试环境配置错误：检查phpunit.xml文件内的数据库连接配置，确认指向的是你预期的测试数据库，而非开发/生产环境库。

单元测试插入数据的最简方式 #

推荐使用Laravel原生的Factory方案，仅需3步即可实现：

1. 在测试类头部引入RefreshDatabase特性，自动处理测试库迁移和数据清理，避免测试间数据互相影响：

use Illuminate\Foundation\Testing\RefreshDatabase;

class UserTest extends TestCase
{
    use RefreshDatabase;

    // 测试方法写在这里
}

2. 确认User模型配置了正确的$fillable属性：

// App/Models/User.php
protected $fillable = [
    'name',
    // 其他需要批量赋值的字段
];

3. 在测试方法中直接调用Factory创建数据即可，默认单条写入不需要加count(1)：

$testUser = User::factory()->create([
    'name' => 'test'
]);

// 直接在测试内做断言验证写入结果即可，不需要查外部库
$this->assertEquals('test', $testUser->name);

如果你不需要用Factory，也可以用修复语法后的DB facade插入语句，效果完全一致。

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