根本原因是FrankenPHP默认不自动注入Content-Type响应头中的charset=utf-8，且Symfony Response未显式设置charset时继承CLI SAPI模糊行为；必须统一PHP文件/Twig模板为UTF-8无BOM、配置php.ini中default_charset="UTF-8"，并在Response或JsonResponse中显式声明charset。
FrankenPHP 作为基于 PHP 的现代 Web 服务器，与 Symfony 集成时若出现响应乱码（如中文显示为 、问号或方块），根本原因不是 FrankenPHP 本身不支持 UTF-8，而是其默认不自动注入 Content-Type 响应头中的 charset=utf-8，且 Symfony 的 Response 对象在未显式设置编码时可能继承底层 SAPI 的模糊行为——这在 CLI 模式启动的 FrankenPHP 中尤为明显。
FrankenPHP 启动时未设置默认 charset
FrankenPHP 默认使用 PHP 的 CLI SAPI 启动，而 CLI SAPI 不会像 Apache 或 FPM 那样自动添加 Content-Type: text/html; charset=UTF-8。即使 Symfony 返回了正确的 Response 对象，若该对象未显式调用 setCharset('utf-8')，且内容类型是 text/html，浏览器就可能按 ISO-8859-1 解析 UTF-8 字节流，导致乱码。
- 检查响应头：用
curl -I http://localhost:8080查看是否含Content-Type: text/html; charset=utf-8 - Symfony 默认不设 charset：
Response构造时不传$charset参数，内部默认为null，最终由headers决定，而非强制推导 - FrankenPHP 不拦截/修正此行为：它忠实地转发 Symfony 生成的响应头，不会“补全”缺失的 charset
- 临时验证：在控制器中手动加
$response->setCharset('utf-8');，乱码消失即证实此路径
Symfony Serializer 输出 JSON 仍乱码
即使返回 application/json，中文字段仍显示为 Unicode 转义（"\u4f60\u597d"）或直接乱码，说明问题出在序列化器配置或响应头未对齐，而非前端解析。
-
SerializerInterface::serialize()默认不带charset参数，JSON 标准虽不强制要求 charset，但 FrankenPHP + 浏览器组合可能忽略 UTF-8 BOM 或误判 - 必须显式设置响应头：
new Response($json, 200, ['Content-Type' => 'application/json; charset=utf-8'])，注意分号后空格无关，但charset=utf-8必须存在 - 避免依赖
format_listener自动推导：它只匹配 MIME 类型，不注入 charset；framework.yaml中的default_format也不控制 charset - 若用
JsonResponse，需确认其构造时传入了$charset = 'utf-8'（Symfony 6.4+ 支持，旧版需手动 setCharset）
PHP 文件与模板编码未统一触发隐式转换
FrankenPHP 运行时加载的 Twig 模板、PHP 控制器、配置文件若混用 GBK/BOM/UTF-8-no-BOM，PHP 解析器可能在 tokenizing 阶段就损坏字符串字节流，后续任何 header 或 serializer 都无法挽救。
立即学习“PHP免费学习笔记（深入）”；
- 所有
.php和.twig文件必须保存为UTF-8 without BOM—— VS Code 中右下角编码栏点击后选 “Save with Encoding → UTF-8”，并**取消勾选 “Add BOM”** - 检查
php.ini：确认default_charset = "UTF-8"已启用（FrankenPHP 读取此值，不同于 FPM 的独立配置） - 禁用
mbstring.func_overload：该选项已废弃，若开启会导致strlen等被重载为mb_strlen，但无默认编码参数，反而引发计算错误 - Twig 模板中避免硬编码中文在
{% set %}外部：例如echo "你好";若文件非 UTF-8，PHP 解析阶段即出错
最易被忽略的是 FrankenPHP 的 php.ini 加载路径 —— 它不读取系统默认的 /etc/php/*/cli/php.ini，而是优先使用项目根目录下的 php.ini 或 FrankenPHP 启动时通过 -c 指定的配置。没配 default_charset，所有响应头 charset 都得靠 Symfony 手动补，而开发者常以为框架已兜底。
