在Laravel单元测试中，对资源更新接口进行测试时，正确传递参数是保证用例稳定的关键。更新操作通常对应RESTful中的PUT或PATCH方法，测试时需要同时提供路由参数与请求体数据。
更新操作的路由与参数结构
假设我们有一个用户更新接口，路由定义为 Route::put('/users/{user}', [UserController::class, 'update'])。在单元测试中，{user} 是路由参数，而用户字段（如 name、email）则应作为请求体以数组形式传递。
使用 put 方法传递参数
Laravel 的测试用例提供了 put 方法，第一个参数为 URI（可包含路由参数），第二个参数为关联数组，即要更新的字段数据。
<?php
namespace TestsFeature;
use AppModelsUser;
use IlluminateFoundationTestingRefreshDatabase;
use TestsTestCase;
class UserUpdateTest extends TestCase
{
use RefreshDatabase;
public function test_user_can_be_updated()
{
$user = User::factory()->create([
'name' => '旧名字',
'email' => 'old@ipipp.com',
]);
// 路由参数通过 URI 拼接，更新字段通过数组传递
$response = $this->put('/users/' . $user->id, [
'name' => '新名字',
'email' => 'new@ipipp.com',
]);
$response->assertOk();
$this->assertDatabaseHas('users', [
'id' => $user->id,
'name' => '新名字',
'email' => 'new@ipipp.com',
]);
}
}
使用 route 辅助函数生成 URL
为了避免手动拼接 URI，可以使用 route() 辅助函数，将路由参数以数组形式传入，更新数据仍作为第二个参数。
<?php
public function test_update_with_route_helper()
{
$user = User::factory()->create();
$response = $this->put(
route('users.update', ['user' => $user->id]),
['name' => '路由参数测试']
);
$response->assertOk();
$this->assertDatabaseHas('users', [
'id' => $user->id,
'name' => '路由参数测试',
]);
}
常见错误与注意点
- 把路由参数误放进请求体数组，导致控制器无法通过
findOrFail()定位模型。 - 使用
get方法模拟更新，不符合语义且可能无法触发更新逻辑。 - 未对邮箱等唯一字段做调整后仍用旧值，引发数据库唯一约束异常。
总结
Laravel 单元测试中为更新操作传递参数的核心在于：路由参数走 URI 或 route() helper，业务字段走请求体数组。掌握这一区分，就能写出清晰且不易出错的更新用例。