Laravel单元测试中如何打印验证异常的具体错误详情？

嘿，我刚好遇到过这个问题！Laravel的API测试里默认的ValidationException确实只会显示那句通用的「The given data was invalid」，看不到具体哪个字段错了，不过有几个实用的办法能帮你拿到完整的错误包内容：

方法1：捕获异常直接打印错误细节 #

最简单的方式就是在测试方法里用try-catch捕获验证异常，然后直接输出错误数组：

public function testCustomerCanStoreNewUser() {
    $this->actingAs($this->customer, 'api');
    $uri = route('users.store');

    try {
        $this->postJson($uri, $this->newUser)
            ->assertCreated()
            ->assertJsonStructure(['success', 'data']);
    } catch (\Illuminate\Validation\ValidationException $e) {
        // 直接打印完整的错误列表，非常直观
        dd($e->errors());
        // 如果你还想让测试保持失败状态，可以再把异常抛出去
        // throw $e;
    }

    $this->assertDatabaseHas('users', $this->newUser);
}

运行测试后，一旦触发验证错误，就会直接输出所有字段的错误信息，比如['email' => ['邮箱格式不正确']]这种结构。

方法2：全局自定义异常处理（适合多个测试用例） #

如果不想每个测试都写try-catch，可以在测试类的setUp方法里自定义异常处理器，专门处理验证异常：

protected function setUp(): void
{
    parent::setUp();

    // 替换默认的异常处理器，专门捕获ValidationException
    $this->app->instance(\Illuminate\Contracts\Debug\ExceptionHandler::class, new class extends \Illuminate\Foundation\Exceptions\Handler {
        public function render($request, \Throwable $e)
        {
            if ($e instanceof \Illuminate\Validation\ValidationException) {
                dump('=== 验证错误详情 ===');
                dump($e->errors());
            }
            return parent::render($request, $e);
        }
    });
}

这样所有测试用例里的验证错误都会自动打印出来，不用重复写捕获逻辑，非常适合批量调试。

方法3：用Laravel自带的断言方法（推荐） #

其实Laravel测试套件提供了专门的断言方法assertJsonValidationErrors，不仅能验证指定字段是否有错误，还会在断言失败时自动展示完整的错误详情：

public function testCustomerCanStoreNewUser() {
    $this->actingAs($this->customer, 'api');
    $uri = route('users.store');

    $response = $this->postJson($uri, $this->newUser);

    // 这里可以指定你要验证的字段，比如email、name
    $response->assertJsonValidationErrors(['email']);

    $response->assertCreated()
             ->assertJsonStructure(['success', 'data']);
    $this->assertDatabaseHas('users', $this->newUser);
}

如果测试触发了验证错误，这个断言会直接在测试报告里输出实际的错误内容，既完成了测试断言，又能看到错误细节，是最符合测试规范的做法。

为什么你之前的方法没用？ #

• $this->withoutExceptionHandling()：它会让异常直接抛出，但Laravel在API场景下，ValidationException的默认输出只会显示通用消息，不会展开errors数组；
• dump()系列方法：如果异常被抛出了，请求响应其实没有正常生成，所以dump()拿不到任何响应内容，自然看不到错误。

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