PHP中利用输出缓冲区批量替换JSON输出的null为空字符串

既然你有500+个Web服务要处理，逐个改肯定不现实，用PHP的输出缓冲区（Output Buffering）来全局拦截并处理JSON输出是最省心的方案。下面给你一套安全可靠的实现方式：

核心思路 #

利用ob_start()开启输出缓冲，注册一个回调函数，在JSON输出到客户端前，先把JSON解析成数组，递归把所有null值替换为空字符串，再重新编码成JSON返回。这种方式比直接正则替换更安全，不会误改字符串里的"null"内容。

实现代码 #

把这段代码放在项目的全局入口文件（比如index.php或者所有服务都会引入的公共配置文件）里，就能自动处理所有输出的JSON：

// 递归替换数组中的null为空字符串
function replaceNullWithEmptyString(&$value) {
    if ($value === null) {
        $value = '';
    } elseif (is_array($value)) {
        array_walk_recursive($value, 'replaceNullWithEmptyString');
    }
}

// 输出缓冲回调函数：处理JSON内容
function jsonNullToEmptyBufferCallback($buffer) {
    // 尝试将缓冲区内容解码为JSON数组
    $data = json_decode($buffer, true);
    
    // 检查解码是否成功（确保是有效的JSON）
    if (json_last_error() === JSON_ERROR_NONE) {
        // 递归替换所有null值
        array_walk_recursive($data, 'replaceNullWithEmptyString');
        
        // 重新编码为JSON，可根据你的需求添加编码选项（比如JSON_UNESCAPED_UNICODE）
        return json_encode($data, JSON_UNESCAPED_UNICODE);
    }
    
    // 如果不是JSON内容，直接返回原缓冲区内容，不影响其他输出
    return $buffer;
}

// 开启输出缓冲并绑定回调
ob_start('jsonNullToEmptyBufferCallback');

为什么不用正则替换？ #

比如你用preg_replace('/:\s*null\s*/', ': ""', $buffer)，看起来简单但有坑：如果JSON里有字符串值正好是"null"（比如{"note": "null is allowed"}），正则会把它改成{"note": "" is allowed"}，直接破坏JSON结构。而解析成数组再处理的方式，只会替换真正的null类型值，完全不会影响字符串内容。

注意事项 #

1. 编码选项匹配：如果你的服务输出JSON时用了特殊编码选项（比如JSON_PRETTY_PRINT、JSON_NUMERIC_CHECK），记得在json_encode时加上对应的选项，保证输出格式和原来一致。
2. 性能考量：解析和重新编码JSON会有轻微性能损耗，但对于大多数Web服务来说完全可以忽略，毕竟比起修改500+服务的成本，这点损耗太值了。
3. 非JSON输出兼容：回调里做了JSON有效性检查，所以如果服务输出的是HTML、纯文本等非JSON内容，会直接返回原内容，不会影响其他类型的输出。

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