前端说接口返回的中文全是 \u5f20\u4e09 这种,看着像乱码。我先怀疑编码,把文件、响应头、数据库连接全查了一遍,utf8mb4 都没问题。json_enCode 默认就会把非 ASCII 转成 \uXXXX,这不是故障,是它的默认行为。
加参数就行,json_encode($data, JSON_UNESCAPED_UNICODE),PHP 5.4 以后都有。麻烦的是加在哪一层。项目是 Laravel 10,控制器里 return response()->json($data),这个 Response 内部还会再 encode 一次,你在中间某个地方先 encode 完再传进去,等于编两遍,出来是一串带引号的字符串。
正确位置是 Response 的 encoding options,链式调 setEncodingOptions。别去 config/app.php 里加什么 json_options,我试过,框架根本不读那个键,白改。
// Laravel 10
return response()
->json($data)
->setEncodingOptions(
JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES
);
// 原生 PHP
echo json_encode($data, JSON_UNESCAPED_UNICODE);
这次真正踩的是另一个坑:网关做了签名校验,签名算的是原始 body。之前 body 里是 \u5f20,两边对得上;改成真中文之后 md5 不一致,接口直接 401。这种改动上线前得跟对接方说一声,或者先只在新接口开。
还有一点,JSON_UNESCAPED_UNICODE 只影响编码,json_decode 那边不用加东西,它本来就能吃 \u 转义。如果数据源本身是 GBK,先 mb_convert_encoding 到 UTF-8,否则 json_encode 返回 false,json_last_error() 报 JSON_ERROR_UTF8,加多少选项都没用。
上线后抓了一次响应,中文正常,包体从 3.2KB 降到 2.1KB。签名那事最后是让对方改了算法,两边同时发版。
