Laravel单元测试中SQLite忽略数据库约束问题排查

嘿，我之前刚好踩过这个坑！这确实是SQLite的默认特性导致的——它默认禁用了外键约束检查，所以哪怕你在迁移里定义了外键关联，测试时也不会生效，这就是为什么你能直接删除有关联数据的Product而不报错。

为什么会这样？ #

SQLite出于性能和兼容性的考虑，默认不会启用外键约束。哪怕你在迁移文件里写了foreign('product_id')->references('id')->on('products')，如果没手动开启约束，它只是个“摆设”，不会真正阻止删除操作。

解决方法 #

你需要做两步配置，确保SQLite在测试环境下启用外键约束：

1. 修改数据库配置文件
   打开config/database.php，找到sqlite的连接配置，添加foreign_key_constraints选项并设为true：

'connections' => [
    'sqlite' => [
        'driver' => 'sqlite',
        'database' => database_path('database.sqlite'),
        'prefix' => '',
        'foreign_key_constraints' => true, // 新增这一行
    ],
    // 其他数据库连接配置...
],

2. 在测试基类中强制开启约束（针对内存数据库）
   如果你测试时用的是内存数据库（比如在phpunit.xml里配置了DB_DATABASE=:memory:），每次测试启动时SQLite会重置状态，所以最好在测试基类的setUp方法里手动执行开启约束的SQL语句：

use Illuminate\Support\Facades\DB;

class TestCase extends Illuminate\Foundation\Testing\TestCase
{
    protected function setUp(): void
    {
        parent::setUp();
        // 强制开启SQLite外键约束
        DB::statement('PRAGMA foreign_keys = ON;');
    }
}

验证效果 #

做完上面的配置后，再运行你的测试：当products:delete命令尝试删除有关联Service的Product时，SQLite会抛出外键约束异常，阻止删除操作，你的assertCount(1, Product::all())断言就能通过了。

另外提醒一下：如果你的命令逻辑里没有处理这个异常，可能需要调整命令代码（比如先检查Product是否有关联的Service，再决定是否执行删除），避免命令运行时直接报错。

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