thinkphp 6 接口返回 json 中文显示为 \uxxxx 是默认行为，真正乱码源于编码源头、json 序列化方式及响应头设置；须确保 php 文件为 utf-8 无 bom，启用 json_unescaped_unicode，并强制响应头为 application/json; charset=utf-8。
ThinkPHP 6 接口返回 JSON 时中文显示为 \uXXXX 形式，不是乱码，而是默认编码行为；真正影响使用的“乱码”通常指浏览器或调试工具中出现问号、方块、空白，或前端解析失败。核心问题集中在三处：编码源头、JSON 序列化方式、HTTP 响应头设置。
确保所有 PHP 文件是 UTF-8 无 BOM 格式
这是最常被忽略却最关键的一环。哪怕一个控制器、配置文件或路由文件开头带了 BOM（EF BB BF），都会导致 json() 前产生不可见输出，使 JSON 格式损坏，浏览器报 Unexpected token in JSON at position 0。
- 用编辑器（如 VS Code、PhpStorm）检查并转换全部 PHP 文件为「UTF-8 without BOM」
- 重点排查：
app/、config/、route/、middleware/目录下的文件 - 禁用任何前置
echo、var_dump()，也避免未定义变量触发 Notice（例如$data['name']但$data不含name键）
让中文不转义：启用 JSON_UNESCAPED_UNICODE
默认 json() 会把中文转成 \u5f20\u4e09，虽不影响解析，但调试困难、日志难读。解决方法分版本：
Json Schema Toolkit
下载
使用 JSON Schema 验证 JSON 数据，从示例 JSON 生成 schema，并将其转换为 TypeScript 接口、Python 数据类或 Markdown 文档。
-
TP6.1+：直接在
config/app.php中添加或修改：
- TP6.0：不支持该配置，可用以下任一方式替代：
- 在控制器中手动调用：
return response(json_encode($data, JSON_UNESCAPED_UNICODE))->header('Content-Type', 'application/json; charset=utf-8'); - 避免混用：
json(json_encode(...))会导致双重编码，务必只用一次序列化
强制响应头为 application/json; charset=utf-8
仅靠前端发 Content-Type: application/json 并不能保证 TP6 返回 JSON——框架会根据 Accept 头或请求类型自动切换响应格式，容易误走 HTML 渲染流程。
- 统一用
return json($data, $code)，不要依赖“发 JSON 请求就自动回 JSON” - 若使用
response()，必须显式设头：response($data)->contentType('application/json') - Postman 或 curl 测试时，务必带上
Accept: application/json，且Content-Type写成application/json（不含; charset=utf-8，某些 TP6.0.x 版本会因此跳过 JSON 解析）
验证数据源本身是合法 UTF-8
如果数据库、配置文件、POST 表单或外部接口传入的数据不是 UTF-8，json_encode() 会直接返回 false，造成空响应或 null。
- MySQL 查询前执行
SET NAMES utf8mb4，PDO 连接时指定charset=utf8mb4 - 读取本地 JSON 或文本文件后，用
mb_detect_encoding($str, ['UTF-8'], true)检查；非 UTF-8 则转：mb_convert_encoding($str, 'UTF-8', 'GBK') - 对可能含非法 UTF-8 字节的数据，加容错标志：
json_encode($data, JSON_UNESCAPED_UNICODE | JSON_INVALID_UTF8_SUBSTITUTE)（PHP 7.2+）
