0

0

Laravel 测试中实现数据库仅在测试开始时重置的正确实践

聖光之護

聖光之護

发布时间:2026-01-09 09:24:35

|

599人浏览过

|

来源于php中文网

原创

Laravel 测试中实现数据库仅在测试开始时重置的正确实践

laravel 的 `refreshdatabase` 特性默认在每个测试前后均重置数据库,但实际测试应聚焦于可重复、自验证的行为断言,而非人工查看 phpmyadmin;本文详解如何通过合理建模、工厂数据与精准断言替代“手动检查”,确保测试真正可靠、可移植且符合 laravel 最佳实践。

在 Laravel 测试中,刻意保留测试后数据库状态以供人工验证(如通过 phpMyAdmin 查看)是一种反模式。原因在于:测试的本质是自动化、可重复、环境无关的契约验证。若依赖外部工具人工核对结果,不仅破坏了测试的原子性与可移植性,还违背了 Laravel 官方倡导的“测试即文档”原则——理想中的测试应能被任何人、在任何干净环境中一键运行(如 php artisan test --group=cleanup),并明确告知“什么被修改了、是否符合预期”。

RefreshDatabase 的设计初衷正是保障这种隔离性:它在测试方法执行前清空并迁移数据库(确保初始状态一致),并在执行后立即回滚或重建(防止测试间污染)。因此,不存在官方支持的“仅开始刷新”选项——这不是功能缺失,而是有意为之的架构约束

ChatGPT Writer
ChatGPT Writer

免费 Chrome 扩展程序,使用 ChatGPT AI 生成电子邮件和消息。

下载

正确的解决方案是将验证逻辑内化到测试本身,通过断言(assertions)精确描述预期状态。以下为推荐实践:

  1. 使用工厂构建可控的初始数据集
    避免模糊的“创建一些用户”,而应显式定义每条记录的关键属性与分类标识(如 type 字段),便于后续精准断言。

  2. 执行待测逻辑(如 Artisan 命令)并验证其副作用
    使用 $this->artisan(...)->assertSuccessful() 确保命令成功执行,再通过 Eloquent 查询获取实际结果。

  3. 编写语义清晰的断言
    优先使用 assertEquals、assertNull、assertCount 等匹配业务意图的断言,而非 assertTrue(DB::table(...)->count() > 0) 这类模糊判断。

namespace Tests\Feature;

use Illuminate\Foundation\Testing\RefreshDatabase;
use Server\Models\User;
use Tests\TestCase;

class TestRemoveCertainData extends TestCase
{
    use RefreshDatabase;

    public function test_removes_emails_for_specific_user_types()
    {
        // Arrange: 创建四种类型用户,明确邮箱状态
        $user1 = User::factory()->create(['type' => 'type1', 'email' => 'user1@example.com']);
        $user2 = User::factory()->create(['type' => 'type2', 'email' => 'user2@example.com']);
        $user3 = User::factory()->create(['type' => 'type3', 'email' => 'user3@example.com']);
        $user4 = User::factory()->create(['type' => 'type4', 'email' => 'user4@example.com']);

        // Act: 执行清理命令
        $this->artisan('remove_data_command')->assertSuccessful();

        // Assert: 验证仅 type2 和 type4 用户邮箱被清空
        $this->assertNull($user2->fresh()->email);
        $this->assertNull($user4->fresh()->email);
        $this->assertNotNull($user1->fresh()->email);
        $this->assertNotNull($user3->fresh()->email);

        // 或批量断言(更简洁)
        $emails = User::orderBy('id')->pluck('email')->toArray();
        $this->assertEquals([
            'user1@example.com',
            null,
            'user3@example.com',
            null,
        ], $emails);
    }
}
⚠️ 注意事项: *勿在测试中调用非 `test方法**(如原示例中的removeCertainData()):PHPUnit 仅自动执行以test开头或标记@test` 的方法;否则该逻辑不会被执行。 避免 factory(...)->create() 在 Laravel 9+ 中已废弃:请改用模型工厂的静态 ::factory()->create() 方法(如上例所示)。 如需调试 SQL,启用日志而非依赖 phpMyAdmin:在 phpunit.xml 中设置 DB_LOG_QUERIES=true,或临时在测试中使用 DB::enableQueryLog() + dd(DB::getQueryLog())。

总结而言,放弃“手动检查数据库”的思维,转向“声明式断言预期状态”,不仅是 Laravel 测试的最佳实践,更是构建高可信度、易维护应用的基石。真正的测试价值,不在于你看到了什么,而在于你证明了什么。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
laravel组件介绍
laravel组件介绍

laravel 提供了丰富的组件,包括身份验证、模板引擎、缓存、命令行工具、数据库交互、对象关系映射器、事件处理、文件操作、电子邮件发送、队列管理和数据验证。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

338

2024.04.09

laravel中间件介绍
laravel中间件介绍

laravel 中间件分为五种类型:全局、路由、组、终止和自定。想了解更多laravel中间件的相关内容,可以阅读本专题下面的文章。

290

2024.04.09

laravel使用的设计模式有哪些
laravel使用的设计模式有哪些

laravel使用的设计模式有:1、单例模式;2、工厂方法模式;3、建造者模式;4、适配器模式;5、装饰器模式;6、策略模式;7、观察者模式。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

708

2024.04.09

thinkphp和laravel哪个简单
thinkphp和laravel哪个简单

对于初学者来说,laravel 的入门门槛较低,更易上手,原因包括:1. 更简单的安装和配置;2. 丰富的文档和社区支持;3. 简洁易懂的语法和 api;4. 平缓的学习曲线。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

384

2024.04.10

laravel入门教程
laravel入门教程

本专题整合了laravel入门教程,想了解更多详细内容,请阅读专题下面的文章。

135

2025.08.05

laravel实战教程
laravel实战教程

本专题整合了laravel实战教程,阅读专题下面的文章了解更多详细内容。

82

2025.08.05

laravel面试题
laravel面试题

本专题整合了laravel面试题相关内容,阅读专题下面的文章了解更多详细内容。

75

2025.08.05

数据分析工具有哪些
数据分析工具有哪些

数据分析工具有Excel、SQL、Python、R、Tableau、Power BI、SAS、SPSS和MATLAB等。详细介绍:1、Excel,具有强大的计算和数据处理功能;2、SQL,可以进行数据查询、过滤、排序、聚合等操作;3、Python,拥有丰富的数据分析库;4、R,拥有丰富的统计分析库和图形库;5、Tableau,提供了直观易用的用户界面等等。

1090

2023.10.12

Swift iOS架构设计与MVVM模式实战
Swift iOS架构设计与MVVM模式实战

本专题聚焦 Swift 在 iOS 应用架构设计中的实践,系统讲解 MVVM 模式的核心思想、数据绑定机制、模块拆分策略以及组件化开发方法。内容涵盖网络层封装、状态管理、依赖注入与性能优化技巧。通过完整项目案例,帮助开发者构建结构清晰、可维护性强的 iOS 应用架构体系。

3

2026.03.03

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PHP课程
PHP课程

共137课时 | 12.9万人学习

JavaScript ES5基础线上课程教学
JavaScript ES5基础线上课程教学

共6课时 | 11.3万人学习

PHP新手语法线上课程教学
PHP新手语法线上课程教学

共13课时 | 1.0万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号