根本原因是FrankenPHP的frankenphp SAPI默认禁用display_errors且不保证output_buffering启用，导致Symfony异常处理无法渲染HTML页面；须在public/index.php顶部强制设置ini_set('display_errors', '1')和ob_start()。
FrankenPHP 下 Symfony 异常页面空白，根本原因不是 Symfony 配置错误，而是 FrankenPHP 的 PHP 运行模式（SAPI）与 Symfony 错误处理机制不兼容：它默认禁用 display_errors，且不触发传统 CLI/Web SAPI 的错误输出通道，导致 Whoops 或 Symfony 默认异常页无法渲染，只返回空响应或 500 状态。
为什么 FrankenPHP 里 Symfony 异常页是空白的
FrankenPHP 使用自研的 frankenphp SAPI，绕过了 Apache/Nginx + PHP-FPM 组合中成熟的错误捕获链。Symfony 的 Kernel::handle() 在捕获未处理异常后，会尝试调用 Debug::enable() 并委托给 ExceptionHandler 渲染 HTML 页面——但该流程依赖 ini_get('display_errors') === '1' 或显式 ob_start() 缓冲控制；而 FrankenPHP 默认关闭所有 PHP 错误显示，且不保证 output_buffering 已启用。
常见现象包括：
- 开发环境访问路由报错，浏览器显示完全空白，Network 面板中 Response 为空、Status 为 500
-
var/log/dev.log里有完整异常堆栈，但前端零输出 - 手动触发
throw new \Exception('test');同样无页面，error_log()却能写入
修复方法：强制启用错误输出与缓冲
不能依赖 .env 或 php.ini 全局设置，必须在请求入口处（即 public/index.php）最顶部插入显式配置：
立即学习“PHP免费学习笔记（深入）”；
// public/index.php
<?php
// 必须放在所有 require 之前
ini_set('display_errors', '1');
ini_set('output_buffering', 'on');
error_reporting(E_ALL);
use App\Kernel;
use Symfony\Component\ErrorHandler\Debug;
// ... rest of the file
注意三点：
-
ini_set('output_buffering', 'on')是关键，FrankenPHP 不自动开启输出缓冲，导致ExceptionHandler的ob_get_clean()拿不到内容 - 不要用
ini_set('display_errors', 'On')—— 字符串'On'在 FrankenPHP 中被当作 false 解析，必须用'1' - 这段代码必须在
require任何 Symfony 类之前执行，否则Debug::enable()初始化时已读取旧配置
验证是否生效的快速检查点
加完配置后，用一个可控异常测试，例如在控制器里写：
public function testError(): Response
{
throw new \RuntimeException('FrankenPHP debug check');
}
访问该路由，应看到完整的 Symfony 异常页面（含堆栈、变量、调试工具栏）。若仍空白，请检查：
- 是否漏掉
ini_set('output_buffering', 'on')—— 这是最常被忽略的一环 - FrankenPHP 版本是否 ≥ 1.1.0（旧版存在 SAPI 输出钩子缺陷，1.1.0+ 已修复基础缓冲支持）
- 有没有其他中间件（如自定义响应拦截器）提前
ob_end_clean()或exit了响应
真正麻烦的从来不是加几行配置，而是 FrankenPHP 的 SAPI 行为游离在 PHP 标准之外——它让“理所当然”的错误输出变成需要手动补全的契约。别信文档里“开箱即用”的说法，output_buffering 和 display_errors 这两个 ini 值，永远要亲手拧紧。
