Win11下ThinkPHP模型操作：解决JSON字段查询与解析的报错问题【教程】-ThinkPHP-PHP中文网

thinkphp在windows 11下json字段问题源于mysql版本（需≥5.7.8）、字段类型（必须为json）、模型$json属性声明、json修改需整体赋值及前端请求解析规范。

win11下thinkphp模型操作：解决json字段查询与解析的报错问题【教程】

在 Windows 11 系统下用 ThinkPHP 开发时，数据库 JSON 字段明明存了数据，模型查出来却是字符串、whereJsonContains 查不到记录、json() 输出空或报错——这些问题不是系统兼容性问题，而是 JSON 类型配置、MySQL 版本、字段定义与框架行为不匹配导致的。

确认 MySQL 是否支持 JSON 查询

ThinkPHP 的 JSON 查询方法（如 whereJsonContains）底层调用 MySQL 原生函数，Win11 自带的 MySQL 8.0 默认支持，但如果你用的是 WAMP/XAMPP 自带的老版本（如 5.6 或 MariaDB 10.2 以下），会直接报错或静默失效。

打开命令行，执行 mysql -u root -p 登录后运行：SELECT VERSION();

若返回结果低于 【5.7.8】，必须升级 MySQL 或改用 whereRaw 手写查询；5.7.8+ 才完整支持 JSON_CONTAINS、JSON_EXTRACT 和 ->> 语法。

再查字段类型：SHOW COLUMNS FROM your_table_name LIKE 'data';，确认 Type 列显示为 【json】，不是 text 或 varchar——否则 ->> 语法会报错。

模型中正确声明 $json 属性

这是最常漏掉的一步：ThinkPHP 不会自动把 JSON 字段转成数组，必须显式告诉模型哪些字段要走 JSON 解析流程。

在模型类顶部添加：protected $json = ['config', 'extra', 'options'];

字段名必须和数据库列名完全一致，包括大小写；不能写成 Config 或 CONFIG，也不能加表前缀。

如果字段值是 NULL，访问 $model->config 会得到 null，不是 [] —— 需要手动判空：$data = $model->config ?: [];

dmap-jsapi-skill

DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。

下载

读取 JSON 字段后修改内容并保存

很多人以为改完数组内部值就能自动更新，其实不会。ThinkPHP 不监听嵌套数组变化，只检测字段是否被整体重新赋值。

先取出完整结构：$profile = $user->profile ?: [];
修改内部值：$profile['age'] = 28;
整体赋回字段：$user->profile = $profile;
调用 save()：$user->save();

跳过第③步直接写 $user->profile['age'] = 28，save() 后数据库 JSON 字段内容完全不变。

处理前端传来的 application/json 请求

Win11 下用 Postman 或 Fetch 发送 JSON 数据时，Content-Type 必须严格为 【application/json】，不能带空格或参数（如 application/json; charset=utf-8 在部分 TP6.0 版本会失败）。

控制器中不要用 $request->input('data.name')，它默认不解析 JSON 请求体。

改用：$data = $request->json(); 获取完整数组，或 $request->json('user.id') 直接取子字段。

如果 $request->json() 返回 null，说明原始请求体解析失败——立刻检查 BOM 头：$raw = $request->getContent(); var_dump(bin2hex(substr($raw, 0, 3)));，输出 【efbbbf】 就是 UTF-8 BOM，需用 ltrim($raw, "\xEF\xBB\xBF") 清理后再 json_decode。

查询 JSON 数组是否包含某值

方法一：用 whereJsonContains（要求 MySQL ≥ 5.7 且字段类型为 JSON）
->whereJsonContains('tags', '"php"') —— 第二个参数必须是合法 JSON 字符串，带双引号；不能写成 'php' 或 "php"（无外层单引号）。

方法二：用 whereRaw 手写（兼容低版本 MySQL）
->whereRaw('JSON_CONTAINS(tags, ?)', [json_encode('php', JSON_UNESCAPED_UNICODE)])

注意：JSON_CONTAINS 第二个参数必须是 JSON 格式字符串，PHP 中要用 json_encode 包一层，否则 MySQL 认为是普通字符串字面量，查询永远不命中。