PHP返回JSON需用json_encode()转数组并设Content-Type头；失败常因非UTF-8编码、资源/闭包/循环引用等，须用json_last_error()排查，输出前确保无多余字符且结构明确。
PHP 返回 JSON 数据，核心就一条：用 json_encode() 把数组转成字符串，再确保 HTTP 响应头正确。不是所有数组都能直接“安全”转，尤其含中文、资源、循环引用或非 UTF-8 编码时会出问题。
为什么 json_encode() 有时返回 null 或空字符串
这是最常卡住的地方——函数失败不报错，只默默返回 null。常见原因：
- 数组里有不能序列化的值，比如
resource（数据库连接、文件句柄）、closure（匿名函数）或对象没实现JsonSerializable - 字符串是 GBK/GB2312 编码，而
json_encode()强制要求 UTF-8；中文乱码或直接失败 - 存在循环引用（A 数组里引用 B，B 又引用 A），PHP 7.4+ 默认拒绝编码
- 数值超限（如
INF、NAN），默认被过滤为null
排查方法：var_dump(json_last_error(), json_last_error_msg()); —— 必加，别靠猜。
怎么安全地把 PHP 数组转成 JSON 并输出
关键不在“怎么转”，而在“怎么转得干净、可被前端正常解析”。实操要点：
立即学习“PHP免费学习笔记（深入）”；
- 确保整个响应体只有 JSON 字符串，不要混入
echo、print或空白符（包括文件末尾的换行） - 必须设置响应头：
header('Content-Type: application/json; charset=utf-8'); - 对含中文的数组，先统一转 UTF-8：
array_map('utf8_encode', $arr)不可靠，推荐用mb_convert_encoding($arr, 'UTF-8', 'auto')配合递归处理 - 启用常见容错选项：
json_encode($arr, JSON_UNESCAPED_UNICODE | JSON_INVALID_UTF8_SUBSTITUTE) - 生产环境建议加一层判断：
if (($json = json_encode($arr)) === false) { http_response_code(500); die('JSON encode failed'); }
关联数组 vs 索引数组：返回结构差异影响前端解析
PHP 数组类型直接影响生成的 JSON 是对象还是数组，这点前端很敏感：
- 纯数字键且连续（如
[0 => 'a', 1 => 'b']）→ 输出["a","b"]（JSON array） - 键名含字符串或不连续（如
['id' => 1, 'name' => 'Tom']或[1 => 'a', 3 => 'b']）→ 输出{"id":1,"name":"Tom"}（JSON object） - 想强制返回数组？用
array_values($arr)清洗键名；想强制对象？给索引数组加(object)$arr（但注意json_encode()对对象字段访问权限有要求）
别依赖前端“自动识别”，后端明确返回结构，比让 JS 做 Array.isArray() 判断更可靠。
常见错误响应和调试建议
前端拿到 Unexpected token ？基本等于 PHP 输出了 HTML（比如报错页面、BOM 头、意外 echo）。检查：
- PHP 文件是否以 UTF-8 无 BOM 格式保存（编辑器里确认，别信后缀）
- 有没有在
json_encode()前输出过任何内容（包括error_log()、echo ''、甚至文件开头的空格） - Apache/Nginx 是否启用了输出缓冲（
ob_start()）但没清理，导致 header 失效 - 用
curl -I查响应头，确认Content-Type真的是application/json
复杂点在于：错误可能藏在 include 的文件里，或者 Composer 自动加载触发了某类的 __toString() 方法输出了不可见字符——这种得逐层关掉日志、插件、钩子来定位。
