PHPUnit只识别以test开头或带@test注解的方法;单元测试应继承PHPUnit\Framework\TestCase而非Tests\TestCase;数据库操作需mock或用内存SQLite;工厂必须用User::factory()->create();文件须放tests/Unit/目录且移除不兼容trait。

直接用 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 测试启用)。
立即学习“PHP免费学习笔记(深入)”;
- ✅ 安全做法:在测试方法里手动切换连接:
User::on('sqlite')->get(),前提是config/database.php里已定义sqlite连接 - ✅ 更干净:用
DatabaseTransactionstrait(需继承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。



















