ThinkPHP 6+需手动检测并转换GBK/GB2312等非UTF-8请求参数，应在控制器基类中封装convertStrEncoding方法，用mb_detect_encoding指定候选编码并开启strict模式，再调用mb_convert_encoding转为UTF-8，且仅处理字符串类型并跳过已为UTF-8的内容。
ThinkPHP控制器里怎么统一处理中文字符编码？
直接说结论：ThinkPHP 6+ 默认使用 UTF-8，但若接收的请求含 GBK/GB2312 编码参数（比如老系统对接、部分硬件设备 POST 数据），input() 或 $request->param() 会读成乱码，不能靠框架自动转。必须手动检测并转换，且要放在控制器基类或中间件中统一做，不能每个方法都写一遍。
为什么不能只用 iconv 或 mb_convert_encoding 硬转？
因为不知道原始编码——用户提交的数据可能来自 Windows 记事本（GBK）、Linux 终端（UTF-8）、iOS 表单（UTF-8）甚至嵌入式设备（GB2312）。硬设 iconv('GBK', 'UTF-8', $str) 遇到本来就是 UTF-8 的内容会崩出 Notice: iconv(): Detected an illegal character；而 mb_convert_encoding($str, 'UTF-8', 'auto') 的 'auto' 实际不靠谱，对纯 ASCII 或短中文识别率极低。
实操建议：
- 优先用
mb_detect_encoding($str, ['UTF-8', 'GBK', 'GB2312'], true)显式指定候选集，并开启 strict 模式（第三个参数为true） - 若检测结果为
false，说明可能是二进制或全 ASCII，可跳过转换 - 检测出编码后，再用
mb_convert_encoding($str, 'UTF-8', $detected)转，避免损毁 - 注意：PHP 的
mbstring.func_overload若开启，会影响strlen等行为，建议关闭，统一用mb_*系列
如何在控制器基类中封装可复用的转换方法？
不要写在每个控制器里，应在 app/controller/Controller.php（基类）中加一个公共方法，供子类调用。注意两点：一是只对字符串类型字段处理，二是避免重复转换（比如已确认是 UTF-8 的值不再动）。
立即学习“PHP免费学习笔记（深入）”；
示例代码（放在基类中）：
protected function convertStrEncoding($value)
{
if (!is_string($value) || mb_check_encoding($value, 'UTF-8')) {
return $value;
}
$encoding = mb_detect_encoding($value, ['UTF-8', 'GBK', 'GB2312'], true);
if ($encoding === false || $encoding === 'UTF-8') {
return $value;
}
return mb_convert_encoding($value, 'UTF-8', $encoding);
}
子控制器中这样用：
public function index()
{
$data = $this->request->param();
array_walk_recursive($data, [$this, 'convertStrEncoding']);
// 后续业务逻辑用 $data，所有字符串已确保为 UTF-8
}
POST 表单和 URL 参数要分开处理吗？
要。URL 参数（$_GET）通常由浏览器自动编码为 UTF-8，但某些国产浏览器或旧版 IE 可能发 GBK；POST 表单（$_POST）更不可信——尤其表单没设 accept-charset="UTF-8" 时，IE 默认用系统编码（Windows 简体即 GBK）。所以 $this->request->param() 返回的数组需整体递归处理，而 $this->request->get() 和 $this->request->post() 可按需单独调用转换。
容易踩的坑：
- 别对整数、布尔、数组、对象调用
mb_detect_encoding，会警告 - 别在
__construct()中提前转换$this->request，因为此时参数还没解析完 - 如果用了多语言扩展或缓存，转换后的字符串要确保不被二次编码（如 JSON 输出前再
json_encode就没问题，它认 UTF-8）
最麻烦的是混合编码：一个数组里有的字段是 UTF-8，有的来自 GBK 设备，必须逐字段判断。没有银弹，只能老实用 mb_detect_encoding + 白名单兜底。
