PHP返回微信小程序的JSON必须是无BOM、UTF-8编码的标准纯数据,需禁用display_errors、清除输出缓冲、声明Content-Type头,并使用json_encode($data, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES)确保中文可读且无多余转义。

PHP 返回给微信小程序的 JSON 必须是标准、无 BOM、UTF-8 编码的纯数据,且不能有额外输出(如空格、警告、Notice)。否则小程序 wx.request 会触发 errCode: -1 或解析失败。
确保 PHP 输出纯 JSON 且无干扰内容
常见错误:开启 display_errors、文件末尾多空行、echo 前有空格、引入了带输出的配置文件。
- 开头加
ob_clean();和ob_end_clean();清除已缓存的输出(临时兜底,但应优先修复源头) - 用
header('Content-Type: application/json; charset=utf-8');显式声明类型 - 避免任何
print_r()、var_dump()、echo在json_encode()前执行 - 检查所有
include/require的文件——尤其是 config.php,是否含 BOM 或换行
使用 json_encode() 的关键参数组合
小程序不支持 GBK、不识别 \uXXXX 以外的 Unicode 转义,且对 null 值敏感。默认 json_encode() 可能返回中文乱码或含 HTML 实体。
- 必须加
JSON_UNESCAPED_UNICODE:否则中文变成\u4f60\u597d,虽合法但可读性差,调试困难 - 建议加
JSON_UNESCAPED_SLASHES:避免 URL 字段中https:\/\/这种转义 - 若数据含
null,确认小程序端能正确处理(部分旧版基础库会跳过 null 字段) - 示例:
echo json_encode($data, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);
验证输出是否真正干净
别只看浏览器里“看起来像 JSON”,要用工具验证原始响应流。
立即学习“PHP免费学习笔记(深入)”;
- 在 Chrome DevTools 的 Network → 点击请求 → Response 标签页,右键 “Save response as…” 保存为 .txt,用十六进制编辑器查是否有 0xEF 0xBB 0xBF(BOM)
- curl 命令验证:
curl -i http://your-api.com/api.php,检查响应头是否含Content-Type: application/json,且 body 开头就是{或[ - 如果返回前有 Warning(如 undefined index),即使设置了
error_reporting(0),也需关掉display_errors(php.ini 中设display_errors = Off或运行时用ini_set('display_errors', '0');)
最常被忽略的是 include 文件的编码和结尾换行——哪怕 config.php 最后多一个空行,PHP 都会把它当作响应体的一部分输出,导致 JSON 解析失败。动手前先用 file -i config.php 查编码,再用 xxd config.php | tail 看末尾字节。









