Laravel PHPUnit测试_PHPUnit单元测试最佳实践【方法】-php教程-PHP中文网

class 'tests\testcase' 报错是因测试类未正确继承该基类或自动加载失效；refreshdatabase 失效主因是数据库配置错误，应使用 sqlite 内存库或显式指定独立测试库。

laravel phpunit测试_phpunit单元测试最佳实践【方法】

直接运行 php artisan test 就能跑测试，但多数失败不是代码问题，而是环境或继承关系没对齐——比如 Class 'Tests\TestCase' 报错、数据库残留、$this->get() 找不到控制器，全都能快速定位修复。

这不是 PHPUnit 没装好，而是测试类找不到基类。Laravel 的测试辅助方法（如 actingAs()、RefreshDatabase）全依赖 Tests\TestCase 这个基类提供应用实例和服务容器。

执行 composer dump-autoload 刷新自动加载（尤其改过命名空间或删过文件后）
确认 tests/TestCase.php 文件存在且没被误删——它不是可选的，是所有功能测试的起点
检查测试类是否真的 extends Tests\TestCase，而不是 PHPUnit\Framework\TestCase（后者没 Laravel 上下文）
如果用的是单元测试（tests/Unit/），且不需要 HTTP 或数据库，可以继承 PHPUnit\Framework\TestCase，但那就不能用 $this->get() 或 RefreshDatabase

它只在你明确指向一个“可重置”的数据库连接时才生效。默认 phpunit.xml 里如果 DB_CONNECTION 还是 mysql 且没配独立库名，它就默默连到你的开发库，清的其实是线上数据——非常危险。

PHP 8.5.5

PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑，通过深度错误修复、底层性能微调以及安全加固，旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范，不包含破坏性变更。

下载

最稳方案：用 SQLite 内存库，在 phpunit.xml 里加这两行：
<env name="DB_CONNECTION" value="sqlite"></env>
<env name="DB_DATABASE" value=":memory:"></env>
要用 MySQL？必须显式指定测试库：
<env name="DB_CONNECTION" value="mysql"></env>
<env name="DB_DATABASE" value="laravel_test"></env>，并提前手动建库：CREATE DATABASE laravel_test;
别在 setUp() 里写 DB::table('users')->truncate()——它绕过事务，破坏 RefreshDatabase 的原子性

关键看你要测什么。不是目录位置决定类型，而是你调用的方法和依赖的上下文。

要发 HTTP 请求、登录用户、查真实数据库 → 必须继承 Tests\TestCase，放 tests/Feature/
只验证一个服务类的计算逻辑、不碰数据库/请求/容器 → 可继承 PHPUnit\Framework\TestCase，放 tests/Unit/，更快更隔离
想 mock 依赖？用 Mockery::mock() 或 $this->createMock()，但注意：只有 Tests\TestCase 提供 $this->mock() 辅助方法（需启用 MockApplication Trait）
工厂写法已变：Laravel 8+ 必须用 User::factory()->create()，不能再用全局 factory() 函数

别试图在测试里“模拟登录表单”，那是功能冗余。Laravel 提供了更直接的认证状态注入方式。

用 Sanctum？$user = User::factory()->create(); $this->withToken($user->createToken('test')->plainTextToken)->postJson('/api/posts')
用 Session？$this->actingAs($user) 就够，它会自动设置 session 和 auth guard
路由没注册？检查 routes/api.php 是否启用，以及 APP_URL 在 phpunit.xml 中是否设为 http://localhost（否则 URL 生成可能出错）
中间件跳过：可在测试中临时移除，比如 Route::middleware(['auth:sanctum'])->group(...) 改成 Route::withoutMiddleware(['auth:sanctum'])->group(...)，但仅限调试，正式测试应保留中间件逻辑