php 生成 json 数据出现中文乱码，通常是因为输出流的字符编码与 http 响应头声明的编码不一致，或者源数据本身不是 utf-8 编码。解决方向是统一全链路为 utf-8：确保数据库连接、php 内部字符串、以及 http header 均使用 utf8mb4 或 utf8。适用条件是服务器环境支持多字节字符处理（php 5.4+ 默认开启 json_unescaped_unicode 优化，但需显式控制），且数据源非二进制流。
强制指定响应头编码
在输出 JSON 之前，必须通过 header() 函数明确告知浏览器客户端当前内容的 MIME 类型及字符集。这是最直接的修复手段，防止浏览器以 GBK 或其他编码解析 UTF-8 字节流导致乱码。
<?php
// 1. 设置响应头，声明内容为 JSON 且编码为 UTF-8
header('Content-Type: application/json; charset=utf-8');
// 2. 模拟从数据库获取的数据（假设已正确查询）
$data = [
'id' => 1,
'name' => '张三',
'status' => 'active'
];
// 3. 生成 JSON 字符串
// JSON_UNESCAPED_UNICODE 确保中文不被转义为 \uXXXX
$jsonString = json_encode($data, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);
if ($jsonString === false) {
// 错误处理：编码失败时返回标准错误结构
http_response_code(500);
echo json_encode(['error' => 'JSON encoding failed'], JSON_UNESCAPED_UNICODE);
exit;
}
// 4. 输出结果
echo $jsonString;
?>
执行上述代码后，浏览器控制台或 API 测试工具将直接显示可读的中文文本。若仍出现乱码，检查第一步 header 是否被后续输出覆盖，或确认 PHP 文件本身的保存编码是否为 UTF-8 无 BOM 格式。
立即学习“PHP免费学习笔记（深入）”；
处理源数据编码转换
当数据来自旧系统、CSV 文件或特定数据库配置（如 latin1）时，PHP 内部的字符串可能并非 UTF-8。此时需在 json_encode 前进行编码转换，否则即使设置了 header，生成的 JSON 也会包含非法字节或乱码。
<?php
// 模拟一个非 UTF-8 编码的输入（例如 GBK 编码的字符串）
$gbkData = mb_convert_encoding('李四', 'GBK', 'UTF-8');
// 关键步骤：检测并转换为 UTF-8
// mb_detect_encoding 尝试识别编码，mb_convert_encoding 进行转换
$utf8Data = mb_convert_encoding($gbkData, 'UTF-8', mb_detect_encoding($gbkData, ['UTF-8', 'GBK', 'GB2312', 'ISO-8859-1'], true));
$result = [
'original' => $gbkData,
'converted' => $utf8Data
];
// 再次强调：确保启用 UNESCAPED_UNICODE
echo json_encode($result, JSON_UNESCAPED_UNICODE);
?>
此分支处理了数据进入 JSON 编码器前的清洗过程。如果 mb_convert_encoding 返回 false 或原样未变，说明源数据可能已是 UTF-8 或编码检测失败，需结合具体业务场景调整检测列表。成功表现为中文在 JSON 中正常显示，失败则需排查 mbstring 扩展是否安装。
验证与边界条件排查
验证方法包括使用 curl 请求接口并查看 raw response headers，确认 content-type 包含 charset=utf-8。同时检查 php.ini 中的 default_charset 配置，建议设置为 utf-8。边界情况涉及特殊符号（如 emoji），需确保数据库字段类型为 utf8mb4，否则 json_encode 会因无法编码而返回 null 或 false，此时应捕获该异常并记录日志，而非静默丢弃数据。
