解决PHP json_encode输出中文乱码或null的问题

一只小鹿

发布时间：2026-10-14 | 2人浏览过

原创

在使用PHP生成API接口或数据传输时，json_encode函数若遇到非UTF-8编码（如GBK、GB2312）的中文内容，往往会导致输出乱码或直接显示为null。为确保JSON数据的准确解析，需要对输入数组中的字符串进行编码转换或特殊处理。

问题背景与成因

PHP的json_encode函数严格要求输入数据为UTF-8编码。如果程序运行环境默认使用GBK等编码，且未进行显式转换，直接调用json_encode便会产生错误结果。虽然早期有观点认为设置编码参数即可解决，但在实际长期运行的项目中，数据源复杂多变，硬编码或单一转换手段可能失效。

方案一：递归转换并URL编码

该方法的核心思路是遍历数组中的所有值，将其转换为UTF-8后，再进行URL编码。最后由前端或接收方解码。这种方式兼容性较好，但需要注意编码和解码过程的对应关系。

第1步：定义递归转换函数

创建一个静态方法，对传入数组进行深度遍历。判断当前节点是否为数组，若是则递归调用；若不是则执行编码转换。

public static function encodeOperations($array)
{
    foreach ((array)$array as $key => $value) {
        if (is_array($value)) {
            // 递归处理子数组
            self::encodeOperations($array[$key]);
        } else {
            // 将字符转为UTF-8后进行URL编码
            $array[$key] = urlencode(mb_convert_encoding($value, 'UTF-8', 'GBK'));
        }
    }
    return $array;
}

注意：此方法假设源数据主要为GBK编码。如果源数据编码不确定，建议先检测或使用更通用的编码检测库。此外，调用方需理解返回的JSON值是经过URL编码的字符串，使用时需配合urldecode。

方案二：通用工具函数封装

为了提升代码复用性，可以将编码转换逻辑封装为通用的数组处理函数。这种方法灵活性更高，支持指定目标编码和源编码，并可选择是否对键名也进行处理。

第1步：实现数组递归处理函数

该函数接受回调函数作为参数，允许灵活处理数组元素。

function arrayRecursive(&$array, $function, $apply_to_keys_also = false)
{
    foreach ($array as $key => $value) {
        if (is_array($value)) {
            arrayRecursive($array[$key], $function, $apply_to_keys_also);
        } else {
            $array[$key] = $function($value);
        }

        if ($apply_to_keys_also && is_string($key)) {
            $new_key = $function($key);
            if ($new_key != $key) {
                $array[$new_key] = $array[$key];
                unset($array[$key]);
            }
        }
    }
    return $array;
}

第2步：构建JSON转换专用函数

利用上述工具函数，先将所有中文字符转为UTF-8并进行URL编码，执行json_encode后，再对整个JSON字符串进行urldecode还原。这是一种“曲线救国”的方法，利用了JSON本身也是字符串的特性。

function JSONEncode($array) {
    // 1. 将所有值转换为UTF-8编码
    arrayRecursive($array, function($value) {
        if(function_exists('mb_convert_encoding')) {
            return mb_convert_encoding($value, 'UTF-8', 'GBK'); // 根据实际源编码调整
        }
        return $value;
    });

    // 2. 再次遍历进行urlencode处理（可选，视具体需求而定，此处参考原逻辑）
    // 注：原逻辑中直接在arrayRecursive中混用encode和json逻辑，略显耦合。
    // 更清晰的现代做法是直接确保数据为UTF-8，无需urlencode/json_decode技巧。
    // 但如果必须兼容旧逻辑，可采用以下方式：
    
    // 重新应用urlencode到所有叶子节点
    arrayRecursive($array, 'urlencode', true);

    // 3. 执行json_encode
    $json = json_encode($array);
    
    // 4. 全局urldecode以还原中文字符
    return urldecode($json);
}

风险提示：第二种方案中的“先urlencode再json_encode再urldecode”属于较老的变通手段。在现代PHP版本中，只要确保输入数组内的字符串均为UTF-8编码，通常无需如此复杂的处理。推荐使用第一种方案的简化版或直接统一数据库连接和文件编码为UTF-8。