Laravel验证测试异常：验证失败时测试静默终止问题咨询

在Laravel项目测试中，当请求不符合验证规则（比如未传必填的endpoint字段）时，测试会直接静默终止，无法获取$validated变量的值；但验证通过时，代码能正常执行，通过dd()输出验证后的数组。

测试代码 #

/** @test */
function individual_request_type_action_1_for_full_endpoint_send_job_to_queue()
{
    Queue::fake();

    Sanctum::actingAs(User::factory()->create());

    // Original
    $task = [
        'code' => $this->faker->unique()->regexify('[A-Z0-9]{10}'),
        'endpoint' => 'https://slim.test/api/',
        'type_action' => 1, // Important for this test
        'scheduled_at' => now()->addSeconds(30)->timestamp,
        'endpoint_is_full' => 1,
    ];

    $response = $this
        ->withHeaders(['Accept' => 'application/json'])
        ->post('api/v1/scheduled-task', $task);
}

控制器代码 #

public function store(Request $request)
{
    $validated = $request->validate([
        'code' => 'max:20',
        'endpoint' => 'required|string',
        'endpoint_is_full' => 'boolean',
        'is_master' => 'boolean',  
        'has_relationships' => 'boolean',
        'town_hall_id' => 'integer|between:1,65535',
        'streetlight_id' => 'integer|between:1,18446744073709551615',
        'command_center_id' => 'integer|between:1,16777215',
        'user_id' => 'integer|between:1,18446744073709551615',
        'action_device' => [
            Rule::requiredIf(!$request->endpoint_is_full),
            'string',
        ],
        'type_action' => [
            'between:0,2',
        ],
        'scheduled_at' => 'integer',
        ],
        'type_identifier' =>  [
            Rule::requiredIf(!$request->endpoint_is_full),
            new Enum(ScheduledTaskTypeModemEnum::class)],
        'excludes' => 'array',
        'includes' => 'array',
        'params' => 'array',
        'payload' => 'array',
        'route' => 'array',
    ]);

    dd($validate);

}

核心原因 #

• 框架自动处理验证异常：Laravel的$request->validate()方法在验证失败时，会自动抛出ValidationException异常。因为你的请求头带了Accept: application/json，框架会自动捕获这个异常，直接返回包含错误信息的JSON响应，同时终止后续代码执行——这就是所谓的“静默终止”，实际上代码是被异常中断了，根本没走到dd()那一步。
• 控制器笔误：控制器最后写的是dd($validate)，但变量名是$validated，不过这个问题只有在验证通过时才会暴露，验证失败时到不了这一行。

解决办法 #

1. 在测试中验证失败场景 #

如果要测试验证失败的情况，可以在测试代码中断言响应的状态码和错误信息：

use Illuminate\Support\Arr;

// 构造缺少endpoint的无效请求数据
$invalidTask = Arr::except($task, 'endpoint');

$response = $this
    ->withHeaders(['Accept' => 'application/json'])
    ->post('api/v1/scheduled-task', $invalidTask);

// 断言响应是422验证错误状态码
$response->assertStatus(422);
// 断言返回的错误信息包含endpoint字段的提示
$response->assertJsonValidationErrors(['endpoint']);

2. 自定义验证失败逻辑 #

如果不想让框架自动处理异常，改用Validator类手动验证，自己控制失败后的流程：

use Illuminate\Support\Facades\Validator;

public function store(Request $request)
{
    $validator = Validator::make($request->all(), [
        // 你的验证规则和之前一致
        'code' => 'max:20',
        'endpoint' => 'required|string',
        // ...其他规则
    ]);

    if ($validator->fails()) {
        // 自定义处理，比如返回自定义格式的错误响应
        return response()->json([
            'status' => 'error',
            'messages' => $validator->errors()->all()
        ], 422);
    }

    $validated = $validator->validated();
    dd($validated); // 这里拼写正确，验证通过时会执行
}

内容的提问来源于stack exchange，提问作者abkrim