thinkphp 8项目中websocket前端需自主实现六态状态机+指数退避重连，json字段须确保数据库类型为json/jsonb、模型声明$json与$jsontype、控制器调用withjson(true)解析请求体，否则通信中断且json数据无法自动转数组。
ThinkPHP 8项目中WebSocket连接断开后前端无法自动恢复通信，同时数据库JSON字段读写时仍为字符串而非数组——这两个问题常并发出现，导致实时数据展示错乱、接口返回结构异常。
WebSocket断点重连：前端状态机+指数退避
服务端用think-swoole不提供前端重连能力，必须由JS自主实现完整生命周期管理。
第一步：定义六态状态机，用枚举控制流转逻辑：const STATE = { IDLE: 'idle', CONNECTING: 'connecting', OPEN: 'open', CLOSING: 'closing', CLOSED: 'closed', RECONNECTING: 'reconnecting' };
第二步：监听onclose事件后立即进入RECONNECTING态，并启动退避计时器：let retryDelay = 100; websocket.onclose = () => { state = STATE.RECONNECTING; setTimeout(connect, retryDelay); retryDelay = Math.min(retryDelay * 1.8, 30000); };
第三步：连接成功后重置延迟并切换OPEN态：websocket.onopen = () => { state = STATE.OPEN; retryDelay = 100; };
第四步：每次重连前检查当前状态是否为CLOSED或RECONNECTING，【避免重复调用connect()触发多个并发连接】。
JSON字段自动序列化：模型层显式声明
TP8虽默认对json类型字段启用自动decode，但仅限find/select查询结果；getData()或__get__()访问仍可能返回原始字符串，必须靠模型配置兜底。
方法一：在模型类中声明$json属性，指定需编解码的字段名：protected $json = ['config', 'extra'];
方法二：配合$jsonType指定目标类型，确保读取时转为关联数组：protected $jsonType = ['config' => 'array', 'extra' => 'array'];
DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
注意：若数据库字段类型不是JSON（如设为TEXT），【TP不会执行json_decode，字段值始终为字符串】；必须确认MySQL字段类型为JSON或PostgreSQL为JSONB。
JSON请求体解析：控制器内显式调用
TP8默认不解析application/json请求体，$request->input()始终为空，必须主动触发JSON解析。
在控制器方法开头调用$request->withJson(true)，此后$input、$post、$param等方法均可从已解析的JSON中取值：$this->request->withJson(true); $name = $this->request->input('name');
若使用TP8.0或更低版本，【withJson()不可用，必须改用$request->json()直接读取】，例如：$data = $this->request->json(); $name = $data['name'] ?? null;
Content-Type头必须严格为application/json，不能带分号和charset参数，否则部分版本会静默失败。
跨库JSON字段查询：手写数据库原生语法
MySQL与PostgreSQL对JSON字段的查询语法完全不同，框架不转换也不兼容，必须按目标库类型分别编写。
MySQL 5.7+ 使用->操作符提取字段：Db::connect('mysql_main')->table('users')->where('config->$.theme', 'dark')->select();
PostgreSQL 使用->>操作符提取文本值：Db::connect('pgsql_log')->table('events')->where("data->>'status'", 'success')->select();
若在MySQL中误用->>，或在PostgreSQL中漏掉>符号，查询将返回空结果且无报错提示——【必须逐库验证SQL语法有效性】。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
