json_encode() 是 php 中将数组或对象转为 json 字符串的唯一标准方式，其返回空字符串或 null 是因输入含 resource、非 utf-8 编码、超范围数值、递归引用等不支持类型；需用 json_last_error_msg() 排查，并确保数据合法、编码统一、大数用字符串处理。
json_encode() 是 PHP 中将数组（或对象）转为 JSON 字符串的唯一标准方式，没有替代函数，也不需要手动拼接。
为什么 json_encode() 有时返回空字符串或 null
这不是函数失效，而是输入数据包含不支持的类型或编码问题：
- 数组中存在
resource类型（如数据库连接句柄、文件指针） - 字符串是 GBK/GB2312 编码，而
json_encode()只接受 UTF-8 - 数值超出 PHP 整型范围（如 64 位大整数在 32 位系统上会变成 float，再被 JSON 序列化为科学计数法或丢失精度）
- 递归引用对象（PHP 7.4+ 会抛出
JsonException，旧版本静默失败）
排查方法：先用 var_dump(json_last_error_msg()) 查错误原因，再用 is_array($data) && array_is_list($data) || is_object($data) 确保结构合法。
json_encode() 常用参数组合与效果
默认行为只处理 ASCII 控制字符和 <code>>&，中文直接输出；加参数才能控制格式和兼容性：
立即学习“PHP免费学习笔记（深入）”；
-
JSON_UNESCAPED_UNICODE：保留中文原样（否则转成\uXXXX） -
JSON_UNESCAPED_SLASHES：不转义/（避免被误解析） -
JSON_PRETTY_PRINT：换行缩进，仅用于调试，线上禁用（体积增大且无意义） -
JSON_INVALID_UTF8_SUBSTITUTE：自动替换非法 UTF-8 字节为 ，避免整个编码失败 -
JSON_THROW_ON_ERROR：让失败时抛出JsonException，而非静默返回false
echo json_encode(['name' => '张三', 'score' => 95], JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);
// 输出：{"name":"张三","score":95}
关联数组 vs 索引数组：输出结果完全不同
PHP 不区分「对象」和「关联数组」，json_encode() 仅靠键名类型判断输出结构：
- 纯数字键且连续（0,1,2…）→ 输出 JSON 数组
[] - 含非数字键（如
'id'、'user_name'）或不连续数字键 → 输出 JSON 对象{} - 混合键名（如
[0 => 'a', 'b' => 'c']）→ 强制输出对象，即使看起来像列表
若需强制转为数组，先用 array_values($arr) 重置键名；若需确保是对象，可封装为 (object)$arr（但注意 public 属性限制）。
中文乱码、emoji 报错、浮点数精度丢失怎么解
这些不是 json_encode() 的 bug，而是数据源头没清理好：
- MySQL 查询前执行
SET NAMES utf8mb4，并用mysqli_set_charset($conn, 'utf8mb4') - 读取文件后用
mb_convert_encoding($str, 'UTF-8', 'auto')统一编码 - 处理大整数（如微信 openid、雪花 ID）时，不要用
int接收，改用string类型存储和输出（加JSON_NUMERIC_CHECK会适得其反） - 浮点数如
3.141592653589793默认保留 14 位，若需完整精度，先用sprintf('%.17g', $float)转字符串再 encode
最稳妥的做法：所有输入数据在进 json_encode() 前，用 json_encode($data, JSON_THROW_ON_ERROR) 包裹，并捕获异常做降级处理（如记录日志 + 返回空对象）。
