企业官网建设流程全解析

接口能通
状态码 200
但返回一堆：
���???

如果你也遇到过这种情况，先别急着骂接口。
我可以先给你一句结论：

👉90% 的“乱码”，不是 API 坏了，是你没处理编码。

先说结论：PHP 本身不会“制造乱码”

PHP 的行为其实很老实：

• 接口返回什么字节
• PHP 就原样接收

真正出问题的，是“编码的理解方式”不一致。

最常见的 5 个根本原因（按出现概率）

① 接口返回编码 ≠ 你页面的编码（第一大坑）

这是出现频率最高的原因。

常见组合翻车：

结果就是：
👉看起来像乱码，其实是“翻译错语言”

✅ 解决方式：

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 的世界。