启用数据填充后Laravel内存测试失效的原因排查

API 探路者

2026-7-8

问题描述

近期将应用升级至Laravel 9，并为单元测试和功能测试配置了内存测试环境：

<env name="DB_CONNECTION" value="inmemory"/>
<env name="DB_DATABASE" value=":memory:"/>

数据库连接配置：

'connections' => [

    'inmemory' => [
        'driver' => 'sqlite',
        'database' => ':memory:',
        'prefix' => '',
    ],

    ...
]

按照Laravel文档推荐，在每个测试类中指定数据填充类：

protected $seeder = ExampleSeederClass::class;

但无论是否使用php artisan test --parallel命令运行测试，所有需要数据填充的测试均失败，报错信息：

Failed asserting that null matches expected ...

将内存数据库替换为磁盘版SQLite（.testing.env配置如下）后，测试可正常通过（仅首次运行需耗时填充数据库）：

DB_CONNECTION=sqlite
DB_DATABASE=testing.sqlite
DB_USERNAME=root
DB_PASSWORD=

请问这是Laravel的Bug吗？若不是，可能的原因是什么？

失败测试示例：

/**
 * @dataProvider idList
 *
 * @return void
 */
public function test_id_verification_method($request, $output)
{
    $user = new User;
    $request = Request::create('/', 'GET');
    $request->merge(['id' => $this->dataName()]);
    $request->setLaravelSession(session());
    $this->assertEquals($output, $user->verify_id($request, $user));
}

原因分析及解决方案

这不是Laravel的Bug，核心原因是SQLite内存数据库的连接隔离特性：

每个SQLite内存数据库实例仅属于单个数据库连接，当创建新的连接时，会生成全新的空内存数据库。
Laravel在测试流程中，可能会在数据填充阶段和测试执行阶段使用不同的数据库连接，导致填充的数据无法被测试代码读取，最终返回null引发断言失败。

具体可能的触发场景：

单元测试未初始化完整数据库上下文：如果测试类继承自PHPUnit\Framework\TestCase而非Laravel的Tests\TestCase，则不会自动启动Laravel的数据库连接管理，填充操作和测试代码可能使用不同的连接，导致数据无法共享。
数据填充时机与连接生命周期不匹配：即使继承了Laravel的TestCase，若测试中手动创建了新的数据库连接（或框架内部因某些操作重建连接），原填充的内存数据库数据会丢失。
测试方法依赖数据库数据但未正确读取：从测试示例看，直接实例化User模型而非从数据库查询，若verify_id方法依赖数据库中已填充的记录，当前实例无法读取到内存数据库中的数据，就会返回null。

对应解决方案：

确保测试类继承Laravel的TestCase：所有需要数据库交互的测试类应继承Tests\TestCase，让框架统一管理数据库连接，保证填充和测试使用同一个内存数据库实例。

配合RefreshDatabase trait控制数据生命周期：使用该trait会在每个测试前重置数据库，同时保证填充的数据在当前连接中可用，可在setUp中手动触发填充：

use Illuminate\Foundation\Testing\RefreshDatabase;

class YourTest extends TestCase
{
    use RefreshDatabase;

    protected function setUp(): void
    {
        parent::setUp();
        $this->seed(ExampleSeederClass::class);
    }

    // ...测试方法
}

调整测试方法的模型获取方式：如果verify_id依赖数据库中的用户数据，应从数据库查询实例而非直接新建，比如用User::find($targetId)来获取已填充的记录。

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