接口能通
状态码 200
但返回一堆：
���??????
如果你也遇到过这种情况，先别急着骂接口。
我可以先给你一句结论：
👉 90% 的“乱码”，不是 API 坏了，是你没处理编码。
先说结论：PHP 本身不会“制造乱码”
PHP 的行为其实很老实：
- 接口返回什么字节
- PHP 就原样接收
真正出问题的，是 “编码的理解方式”不一致。
最常见的 5 个根本原因（按出现概率）
① 接口返回编码 ≠ 你页面的编码（第一大坑）
这是出现频率最高的原因。
常见组合翻车：
| 接口返回 | 页面输出 |
|---|---|
| GBK | UTF-8 |
| UTF-8 | GBK |
结果就是：
👉 看起来像乱码，其实是“翻译错语言”
✅ 解决方式：
header("Content-Type: text/html; charset=utf-8");
如果接口是 GBK：
echo mb_convert_encoding($result, 'UTF-8', 'GBK');
② 接口声明是 UTF-8，实际却是 GBK（很坑）
很多老接口，嘴上说 UTF-8，身体却是 GBK。
你看到的 header 可能是：
Content-Type: application/json; charset=utf-8
但实际返回内容是 GBK。
📌 这种只能 自己转码。
③ JSON 本身没问题，是 echo 输出阶段乱码
接口返回 JSON，看起来是乱码，其实是：
- PHP 文件编码不是 UTF-8
- 文件带 BOM
- 编辑器保存成 GBK
📌 常见翻车场景：
“我 var_dump 看着正常，一 echo 就乱码”
④ curl 没指定编码，浏览器自己乱猜
浏览器有时候会“好心办坏事”。
解决方法很简单：
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Accept-Charset: utf-8'
]);
⑤ 你以为是乱码，其实是 gzip 压缩没解
接口返回的是 gzip 压缩内容。
表现形式：
- 看着像乱码
- 实际是压缩后的二进制
解决方法：
curl_setopt($ch, CURLOPT_ENCODING, '');
让 curl 自动解压。
一步步排查流程（照这个顺序来）
不要乱试，按顺序来最快：
1️⃣ 看接口原始返回（Postman / curl）
2️⃣ 看接口 header 里的 charset
3️⃣ 确认 PHP 文件编码
4️⃣ 明确当前页面输出编码
5️⃣ 必要时手动转码
📌 90% 的问题，前三步就能定位。
四、实战排查示例（非常常见）
场景：
- 第三方接口返回中文
- 浏览器显示乱码
正确处理姿势：
$result = curl_exec($ch);
// 假设接口是 GBK
$result = mb_convert_encoding($result, 'UTF-8', 'GBK');
header("Content-Type: application/json; charset=utf-8");
echo $result;
这些“错误解决方式”，你可能也试过
❌ 乱 iconv
❌ 连续转码
❌ 改 PHP.ini 瞎试
❌ 怀疑数据库
❌ 怀疑服务器
一句话：
👉 不确认编码，所有操作都是碰运气。
如何从源头避免乱码？
给你 3 条铁律：
1️⃣ 项目统一 UTF-8（无 BOM）
2️⃣ 接口、页面、数据库编码一致
3️⃣ 转码只做一次
一句话总结（适合结尾）
PHP 调 API 乱码的本质不是“字符坏了”，
而是：
你用 UTF-8 的眼睛，看 GBK 的世界。
