PHP 8.2 接口中文一直变成 Unicode 转义 | JSON_UNESCAPED_UNICODE 加在哪层

前端说接口返回的中文全是 \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。签名那事最后是让对方改了算法,两边同时发版。

您可以还会对下面的文章感兴趣: