PHP接口输出中文乱码的根源在于未设置Content-Type头中的charset=utf-8,导致微信小程序按ISO-8859-1解析UTF-8中文。

PHP接口输出中文乱码的根源在哪
微信小程序调用 PHP 接口返回中文变成问号或方块,90% 是因为 PHP 脚本没明确告诉浏览器(或小程序)“我发的是 UTF-8”。PHP 默认不自动设置 Content-Type 字符集,echo 或 json_encode 输出时只管内容,不管头信息。
必须在输出前加 header('Content-Type: application/json; charset=utf-8')
这不是可选项,是强制动作。只要接口返回 JSON(小程序 wx.request 默认解析 JSON),就必须带这个头,否则微信基础库会按 ISO-8859-1 解析字节流,UTF-8 中文直接崩坏。
常见错误写法:
- 把
header()写在echo或print之后 → 报Warning: Cannot modify header information - 只写
header('Content-Type: application/json'),漏掉; charset=utf-8 - 用
mb_internal_encoding('UTF-8')代替 HTTP 头 → 它只影响 mb_* 函数内部编码,不改变 HTTP 响应头
正确示例:
立即学习“PHP免费学习笔记(深入)”;
'你好,世界']; echo json_encode($data, JSON_UNESCAPED_UNICODE); ?>
PHP 文件本身编码也得是 UTF-8 无 BOM
如果 PHP 源文件保存为 UTF-8 with BOM,BOM(Byte Order Mark)会作为不可见字符提前输出,导致 header() 调用失败,进而引发乱码或空白响应。
验证和修复方法:
- 用 VS Code / Sublime / Notepad++ 打开 PHP 文件 → 查看右下角编码显示,确认是
UTF-8,不是UTF-8 with BOM - 在 VS Code 中:右下角点击编码 → 选择
Save with Encoding→ 选UTF-8 - 用命令行检查:
file -i your_api.php,输出中应含charset=utf-8,不含bom
小程序端也要注意 responseType 和解码逻辑
虽然乱码主因在 PHP 端,但小程序侧配置不当也会放大问题:
- 不要手动用
decodeURIComponent或unescape处理响应体 ——json类型响应已由微信自动 UTF-8 解码 - 确保
wx.request的dataType是'json'(默认值),而非'text' - 若后端返回非 JSON(比如纯文本 HTML),需显式设
responseType: 'text'并手动处理编码,但这种情况极少用于小程序 API
真正容易被忽略的是:PHP 的 json_encode 默认会把中文转成 \uXXXX 形式,而小程序能正常还原;但如果你加了 JSON_UNESCAPED_UNICODE(推荐),就必须确保整个链路——文件编码、HTTP 头、传输过程——全是干净的 UTF-8,缺一不可。











