ThinkPHP在Windows 11下JSON字段问题源于MySQL版本（需≥5.7.8）、字段类型（必须为json）、模型$json属性声明、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 和 ->> 语法。
立即学习“PHP免费学习笔记（深入）”；
再查字段类型：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 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 认为是普通字符串字面量，查询永远不命中。
