Laravel PHPUnit单元测试与功能测试完整指南-php教程-PHP中文网

单元测试与功能测试必须职责分离：单元测试隔离验证内部逻辑，禁用http/数据库；功能测试走完整链路，需refreshdatabase等保障环境纯净。

laravel phpunit单元测试与功能测试完整指南

单元测试和功能测试不是“选一个用”，而是必须分清职责、各守边界——单元测试不碰 HTTP 和数据库，功能测试必须走完整请求链路，混用会导致断言失效、状态污染、CI 频繁失败。

单元测试只验证单个方法或类的内部逻辑是否符合预期，比如计算、转换、条件分支。它不该触发数据库查询、不发 HTTP 请求、不依赖中间件或认证状态。

功能测试里 $this->post() 或 $this->postJson() 报 419（CSRF）或 500（服务器错误），基本是环境配置或迁移没到位，不是代码逻辑问题。

Laravel Creem Agent

Creem 支付商店助理 — 查询订阅、客户、交易、产品，执行心跳检查，管理本地 Laravel支付商店。

下载

确认 phpunit.xml 中设置了 <env name="DB_CONNECTION" value="sqlite"></env> 和 <env name="DB_DATABASE" value=":memory:"></env>
检查 app/Http/Kernel.php 的 web 或 api 中间件组是否误加了 VerifyCsrfToken::class；Laravel 测试默认已禁用 CSRF，加了就会触发 419
500 常因迁移未执行：运行 php artisan migrate:fresh --seed 一次，或在测试类中使用 use RefreshDatabase; trait（它自动处理事务级重置）
别手动在 setUp() 里调 Artisan::call('migrate')——它会拖慢测试速度，且破坏并行执行能力

测需要登录态的接口，关键不是“模拟登录表单”，而是跳过认证流程、直接注入用户上下文。否则你会陷入 session、token、guard 多层耦合，测试变得脆弱且难维护。

用 $this->actingAs($user)：适用于 web 路由，自动设置 session 和 guard
用 $this->withToken($token)：适用于 Sanctum 或 Passport API，$token = $user->createToken('test')->plainTextToken
别写 $this->post('/login', [...]) 再 assert redirect——这属于“测登录功能”，不是“测需登录的功能”
如果接口同时校验权限（如 can:delete post），记得给 $user 分配对应角色或权限，用 $user->givePermissionTo('delete post')

RefreshDatabase 不是“每次删库重建”，它的行为取决于数据库驱动。理解这点，才能避免数据残留或外键报错。

对 sqlite:memory：每次测试用独立内存 DB，最快，但不支持外键约束（constrained() 会静默失败）
对 MySQL/PostgreSQL：它用事务包裹每个测试，rollback 回滚所有变更；但如果测试里用了 DB::statement('TRUNCATE TABLE ...') 或 DB::unprepared()，事务无法回滚，数据就留住了
别在测试中写 DB::connection('mysql')→table('users')→truncate()——它绕过 Eloquent，也绕过 RefreshDatabase 的事务机制
要预设数据，优先用工厂：User::factory()->count(5)->create()，它走 Eloquent，受事务保护