看似有效的UTF-8字符导致PHP json_encode()失效问题求助

问题根源 #

核心问题是编码链路完全断裂：数据库用utf8mb4（UTF-8超集）存储数据，但PHP脚本强制输出ISO-8859-1编码，导致从数据库取出的UTF-8字符串被错误转码，json_encode识别为无效UTF-8字符，最终返回空值或抛出编码错误。

分步解决方案 #

1. 修正输出Content-Type头
   JSON规范要求必须使用UTF-8编码，立刻替换你的输出头：

   header("Content-Type: application/json; charset=utf-8");
   

   不要再用text/html; charset=ISO-8859-1，这会彻底打乱字符串的编码逻辑。

2. 对齐数据库连接编码
   从数据库取数据时，必须让连接编码与数据库的utf8mb4保持一致：

   • 用mysqli的话，连接成功后执行：

     mysqli_set_charset($dbConn, 'utf8mb4');
     

   • 用PDO的话，在DSN里直接指定charset：

     $pdo = new PDO('mysql:host=localhost;dbname=your_db;charset=utf8mb4', $user, $pass);
     

   这一步是保证从数据库拿到的字符串为原生UTF-8编码的关键。

3. 临时修复已混乱的字符串
   如果已经取出编码错误的字符串，可以手动转码急救：

   // 先检测当前编码，再转成标准UTF-8
   if (mb_detect_encoding($Array['name'], 'ISO-8859-1', true)) {
       $Array['name'] = mb_convert_encoding($Array['name'], 'UTF-8', 'ISO-8859-1');
   }
   

   注意这只是临时方案，根源问题还是要靠前两步解决。

4. 简化json_encode参数
   不需要堆砌冗余参数，正常场景下用以下写法即可：

   json_encode($Array, JSON_UNESCAPED_UNICODE);
   

   只有确认存在少量无效UTF-8字符时，再考虑添加JSON_INVALID_UTF8_SUBSTITUTE做容错，但前提是字符串本身编码逻辑正确。

为什么之前的尝试无效？ #

你添加的JSON_PARTIAL_OUTPUT_ON_ERROR和JSON_INVALID_UTF8_SUBSTITUTE只是容错机制，无法解决编码本身错误的问题——当ISO-8859-1编码的字符串被当成UTF-8处理时，重音字符的字节序列在UTF-8规则下就是无效的，所以json_encode依然会报错或返回空值。

内容的提问来源于stack exchange，提问作者Erik