Laravel测试时如何仅重置数据库记录而非删除整个数据库？

当然可以解决这个问题！既然你的项目是从无框架PHP迁移过来的，没有完整的迁移文件，那确实没必要每次测试都删表重建——我们完全可以只清空表中的数据，保留表结构。下面给你两种实用的实现方式：

方式一：自定义通用测试Trait（推荐） #

创建一个可复用的Trait，让所有需要重置数据的测试类都能轻松使用：

1. 在tests/Traits目录下新建TruncateDatabase.php文件（如果Traits目录不存在就手动创建）：

<?php

namespace Tests\Traits;

use Illuminate\Support\Facades\DB;

trait TruncateDatabase
{
    protected function setUp(): void
    {
        // 先执行父类的setUp基础逻辑
        parent::setUp();

        // 每次测试开始前自动清空数据
        $this->truncateTables();
    }

    protected function truncateTables()
    {
        // 临时禁用外键约束，避免清空数据时触发关联报错
        DB::statement('SET FOREIGN_KEY_CHECKS=0;');

        // 获取当前数据库的所有数据表
        $tables = DB::connection()->getDoctrineSchemaManager()->listTableNames();
        
        // 排除不需要清空的系统表，比如迁移记录表、密码重置表等，根据你的项目实际调整
        $excludeTables = ['migrations', 'password_resets', 'failed_jobs'];

        foreach ($tables as $table) {
            if (!in_array($table, $excludeTables)) {
                // 清空表数据（TRUNCATE比DELETE执行更快，还会自动重置自增ID）
                DB::table($table)->truncate();
            }
        }

        // 恢复外键约束，保证后续数据操作的完整性
        DB::statement('SET FOREIGN_KEY_CHECKS=1;');
    }
}

2. 在你的测试类中使用这个Trait，替代RefreshDatabase：

<?php

namespace Tests\Feature;

use Tests\Traits\TruncateDatabase;
use Illuminate\Foundation\Testing\TestCase;

class UserManagementTest extends TestCase
{
    // 用自定义的TruncateDatabase替代原生的RefreshDatabase
    use TruncateDatabase;

    /** @test */
    public function test_user_can_be_created()
    {
        // 你的测试逻辑...
    }
}

方式二：针对特定表手动清空 #

如果只需要清空部分业务表的数据，不需要全局处理，可以直接在测试类的setUp方法中写针对性逻辑：

protected function setUp(): void
{
    parent::setUp();

    // 禁用外键约束
    DB::statement('SET FOREIGN_KEY_CHECKS=0;');
    
    // 只清空你需要重置的业务表
    DB::table('users')->truncate();
    DB::table('orders')->truncate();
    DB::table('products')->truncate();
    
    // 恢复外键约束
    DB::statement('SET FOREIGN_KEY_CHECKS=1;');
}

注意事项 #

• 如果你使用的是MySQL之外的数据库（比如PostgreSQL），禁用外键约束的语句会不同：
  • PostgreSQL可以用TRUNCATE TABLE table_name RESTART IDENTITY CASCADE;来自动处理关联数据的清空，不需要手动禁用约束。
• TRUNCATE会重置表的自增ID，如果你的测试不需要重置自增ID，可以改用DB::table($table)->delete();，但TRUNCATE的执行效率更高。

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