TP5.1 数组转换 JSON 失败？统一字段类型避免资源类型混入

ThinkPHP 5.1 数组转 JSON 失败，归根结底是字段中混入了资源类型或编码不一致。解决思路很简单：先遍历清理非法项，再统一转成 UTF-8，最后用 json() 函数安全输出。但有个细节容易被忽略——漏掉空 header 数组会直接报 Array to string conversion 错误。

在 ThinkPHP 5.1 中，数组转 JSON 失败的原因通常很简单：要么是字段里混入了资源类型，比如数据库连接、文件句柄这些没法序列化的东西；要么是编码不一致，导致 json_encode() 直接返回 false。接口要么空响应，要么直接报错 Array to string conversion。

检查并清理数组中的非法类型

遍历数组，用 is_resource() 和 gettype() 把那些不可序列化的项揪出来。代码很简单，但这一步必须做——json_encode() 遇到 resource 或未实现 JsonSerializable 的对象会静默失败，返回 false。TP5.1 的 json() 方法不会主动抛异常，只会输出空内容，所以排查起来很头疼。

字符串值也得检查一遍，强制转成 UTF-8。别依赖 mb_detect_encoding() 的自动判断，它不靠谱。直接用 mb_check_encoding() 检测，有问题就转。注意，不要用 iconv() 替代 mb_convert_encoding()，iconv 对非法字符默认截断，可能会丢数据。

TP5.1 接口层安全输出 JSON

推荐用 json() 辅助函数，像这样：
return json($data, 200, [], ['json_encode_param' => JSON_UNESCAPED_UNICODE]);

注意第三个参数必须传空数组，漏掉会报 Array to string conversion 错误。或者手动构造 Response 实例：
return response()->json($data, 200, [], JSON_UNESCAPED_UNICODE);

TP5.1 已经不再支持 ajaxReturn() 了，调用会报 Method not found: thinkResponse::ajaxReturn。

模型层 JSON 字段写入防双重编码

数据库字段是 JSON 类型时，比如 MySQL 的 json 列，必须同时配置 $type 和 $json。字段名必须与数据库列名完全一致，大小写和下划线都不能错。只配置其中一个，JSON 功能都会失效。

赋值时直接传原生数组：
$model->config = ['timeout' => 30, 'retry' => 3];
$model->sa ve();

禁止在赋值前手动 json_encode()，否则 TP 会再 encode 一次，存库时就会变成双重编码的字符串。