PHPUnit测试Laravel方法详解

本文深入解析了在 Laravel 项目中使用 PHPUnit 编写单元测试的常见陷阱与最佳实践，直击开发者最易踩坑的五大核心问题：测试方法命名必须以 `test` 开头或标注 `@test` 注解，否则会被完全忽略；单元测试应继承轻量级的 `PHPUnit\Framework\TestCase`（或 `Tests\Unit\TestCase`），而非专为功能测试设计的 `Tests\TestCase`，避免因误用 HTTP 辅助方法导致崩溃；数据库操作需严格隔离——通过手动切换至内存 SQLite 或合理使用 `DatabaseTransactions`，绝不可直接操作开发数据库；Laravel 8+ 起必须改用 `Model::factory()->create()` 替代已废弃的全局 `factory()` 函数；最后务必确保测试文件置于 `tests/Unit/` 目录，并移除不兼容的 trait（如 `RefreshDatabase`），否则将引发静默失败或异常。掌握这些细节，才能让 `php artisan test` 真正跑起来、跑得稳、跑得准。

直接用 php artisan test 就能跑，但多数失败不是代码写错了，而是测试类没继承对基类、数据库配置没切到隔离环境、或者测试方法命名不符合 PHPUnit 规则。

test 方法名必须以 test 开头或加 @test 注解

PHPUnit 不识别 function checkUserCreation() 这种命名。它只扫描以 test 开头的方法（如 test_user_can_be_created），或带 @test 注释的普通方法。

• ✅ 正确：public function test_user_can_be_created() { ... }
• ✅ 也行：/** @test */ public function user_can_be_created() { ... }
• ❌ 错误：public function checkUserCreation() { ... } —— 运行时直接被跳过，还显示 “No tests executed”

单元测试别继承 Tests\TestCase（除非真要用 HTTP 辅助方法）

单元测试的目标是验证单个类/方法逻辑，不走路由、不发请求、不连真实数据库。但 Tests\TestCase 是为功能测试设计的，自带 $this->get()、$this->actingAs() 等——这些在纯单元测试里不仅没用，还会因未初始化 HTTP 内核而报错（比如 Target class [App\Http\Controllers\HomeController] does not exist）。

• ✅ 推荐：单元测试类继承 PHPUnit\Framework\TestCase 或 Laravel 提供的轻量基类 Tests\Unit\TestCase（如果项目有定义）
• ✅ 示例：class PriceCalculatorTest extends \PHPUnit\Framework\TestCase
• ❌ 常见坑：所有测试都统一继承 Tests\TestCase，结果单元测试一调用 $this->get() 就崩，还查半天路由

数据库操作在单元测试里要么 mock，要么用内存 SQLite

单元测试原则上不该碰真实数据库，但偶尔要测 Eloquent 模型方法（比如 scope 或 accessor），又不想写 mock——这时可以临时启用内存 SQLite，但必须手动配好连接，不能依赖 RefreshDatabase trait（它只在 Tests\TestCase 下生效，且默认只对 Feature 测试启用）。

• ✅ 安全做法：在测试方法里手动切换连接：User::on('sqlite')->get()，前提是 config/database.php 里已定义 sqlite 连接
• ✅ 更干净：用 DatabaseTransactions trait（需继承 Tests\TestCase），但它会开启事务回滚，适合小范围模型逻辑验证
• ❌ 危险操作：在单元测试里直接写 DB::table('users')->insert(...) 且没切库——它会往开发库写数据

factory() 函数已废弃，必须用模型静态调用

Laravel 8+ 移除了全局 factory() 函数。如果你在单元测试里还写 factory(User::class)->create()，会直接抛 Call to undefined function factory()。

• ✅ 正确写法：User::factory()->create() 或 User::factory()->count(3)->create()
• ✅ 如果模型没定义工厂，运行 php artisan make:factory UserFactory --model=User
• ❌ 注意：工厂生成的数据默认走当前 DB 连接，所以仍要确保测试前 DB 已切到 sqlite 或事务模式，否则污染开发库

最容易被忽略的是：单元测试文件放错目录（比如扔进 tests/Feature/），或没删掉自动生成的 use Illuminate\Foundation\Testing\RefreshDatabase; ——trait 加了但基类不支持，运行时静默失败或报奇怪的 BadMethodCallException。

今天关于《PHPUnit测试Laravel方法详解》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于的内容请关注golang学习网公众号！