php中json_encode返回空字符串或null,主因是输入数据含非utf-8字符、资源/闭包等不可序列化类型、循环引用;需用mb_convert_encoding转码、is_resource过滤、json_last_error_msg()定位,并启用json_throw_on_error提升可调试性。

PHP中json_encode返回空字符串("")或null,通常不是函数本身出错,而是输入数据不符合JSON规范,导致编码失败。最常见原因是数据包含非UTF-8编码字符、不可序列化的类型(如资源、闭包)、循环引用,或设置了JSON_INVALID_UTF8_IGNORE但未正确处理乱码。
检查并统一字符编码为UTF-8
PHP的json_encode严格要求字符串为UTF-8编码。若数据来自数据库、文件或用户输入且含GBK、ISO-8859-1等编码,会静默失败:
- 用
mb_detect_encoding($str, ['UTF-8', 'GB2312', 'GBK'], true)检测原始编码 - 用
mb_convert_encoding($str, 'UTF-8', '原编码')转换(例如mb_convert_encoding($str, 'UTF-8', 'GBK')) - 对整个数组递归转换:可封装函数遍历键值,对字符串类型做转码
排除不可序列化数据类型
json_encode无法处理资源(如mysqli连接)、闭包、SimpleXML对象等。若数组中混入这类值,整体会编码为空:
- 用
is_object($val) && !method_exists($val, '__toString')粗筛对象 - 对资源类型用
get_resource_type($val)判断,提前unset或替换为null/字符串标识 - 数据库结果集建议用
fetch_all(MYSQLI_ASSOC)而非fetch_object(),避免对象残留
检测并修复循环引用
当数组或对象存在自我引用(如父对象含子对象,子对象又持父引用),json_encode会返回false(开启JSON_THROW_ON_ERROR则抛异常):
- 使用
json_last_error()和json_last_error_msg()定位错误原因 - 临时移除疑似循环字段再试,例如
unset($data['parent']) - 对复杂对象,考虑用
__sleep()方法指定需序列化的属性
启用错误提示并验证返回值
默认json_encode失败只返回false或空字符串,不报错,易被忽略:
- 始终检查返回值:
$json = json_encode($data); if ($json === false) { echo json_last_error_msg(); } - PHP 7.3+ 可加
JSON_THROW_ON_ERROR标志,让失败直接抛JsonException - 调试时用
var_dump($data)确认结构,特别留意NULL、resource、object等类型
不复杂但容易忽略
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











