如何让Symfony在PHPUnit功能测试中显示异常

我太懂你这种困扰了！单元测试里异常一出现就直接弹出来，排查起来超顺畅，结果切换到功能测试，异常居然藏在HTML响应里，得扒半天页面才能找到问题，简直浪费时间。给你几个实用的办法，帮你把异常“揪出来”：

1. 关闭Client的异常捕获，让异常直接抛出 #

这是最直接的解决方案，和单元测试的体验看齐。只需要在创建Client后加上一行代码，关掉它的异常捕获机制：

$client = static::createClient();
$client->catchExceptions(false); // 关键配置！
$client->request('GET', '/你要测试的路由');

默认情况下，WebTestCase的Client会自动捕获异常并生成Symfony的错误页面，关掉这个开关后，只要请求过程中触发异常，测试就会直接抛出完整的异常栈信息，测试失败时你能立刻看到问题根源。

2. 快速查看响应里的异常内容 #

如果你需要保留错误页面的完整信息，但又不想手动翻HTML，可以在测试里直接打印响应内容，或者提取异常文本：

$response = $client->request('GET', '/你要测试的路由');

// 打印整个响应的HTML内容，直接看错误信息
echo $response->getContent();

// 或者精准提取Symfony错误页面里的异常消息
$crawler = $client->getCrawler();
if ($crawler->filter('.exception-message')->count() > 0) {
    echo "异常消息: " . $crawler->filter('.exception-message')->text();
}

这个方法适合你需要同时查看错误页面样式或其他内容的场景。

3. 全局配置测试环境的错误抛出级别 #

如果你想让所有功能测试都自动抛出异常，可以修改测试环境的配置文件config/packages/test/framework.yaml，调整错误处理器的设置：

framework:
    error_handler:
        throw_at: -1 # 抛出所有级别错误和异常

这样一来，不管有没有设置catchExceptions(false)，测试环境里的所有异常都会直接抛出，不会生成错误页面。

小彩蛋：用Profiler查看异常详情 #

如果你开启了测试环境的Web Profiler，还能通过Profiler直接获取异常对象：

$client->request('GET', '/你要测试的路由');

if ($profile = $client->getProfile()) {
    $exceptionCollector = $profile->getCollector('exception');
    if ($exceptionCollector->hasException()) {
        var_dump($exceptionCollector->getException());
    }
}

不过要注意，得先在config/packages/test/web_profiler.yaml里开启Profiler：

web_profiler:
    enabled: true

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