ThinkPHP返回JSON中文乱码需显式设置Content-Type为application/json; charset=utf-8；前端响应为空多因异常未捕获或流程中断；token验证失败常因请求未携带cookie；SyntaxError多因响应流被污染。
ThinkPHP返回JSON时中文乱码
默认用 json() 方法返回中文，浏览器看到的是 Unicode 转义（如 \u4f60\u597d）或直接乱码，本质是没设 Content-Type 或没声明 UTF-8 编码。
- 必须显式设置响应头：
return json($data)->header(['Content-Type' => 'application/json; charset=utf-8']); - 如果用了
Response::create($data, 'json')，记得加->contentType('application/json; charset=utf-8') - 切勿依赖框架自动推断编码——ThinkPHP 6 默认不带
charset=utf-8，哪怕你数据本身是 UTF-8 字符串
前端Ajax接收不到status=200但response为空
常见于后端抛了异常但没被捕获，或者中间件中断了流程，导致响应体为空、状态码却是 200。浏览器 fetch/XHR 看似成功，实际 data 是空对象或 null。
- 检查是否在控制器里写了
exit、die或提前return了非 JSON 数据（比如 echo 了一段字符串） - 确认没被
Validate失败后静默跳过（例如$this->validate($data, $rule)返回 false 却没处理） - 开启调试模式（
app_debug = true），看日志里有没有PHP Warning或未捕获的Exception，这类错误常让 JSON 输出中断
ajax提交表单时token验证失败
ThinkPHP 的 token 验证默认绑定 session，而某些前端框架（如 Vue + axios）发起请求时不带 cookie，导致 token 校验始终不通过。
dmap-jsapi-skill
下载
DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
- 确保前端请求携带凭证：
axios.post(url, data, { withCredentials: true })；fetch 则要加credentials: 'include' - 后端不能禁用 session（
session.auto_start = false会导致 token 生成/校验失效） - 若用多级子域名或前后端分离部署，检查
session.cookie_domain和cookie.path是否匹配，否则 token 值根本传不过来
使用json()方法但前端解析报SyntaxError
错误提示类似 Unexpected token ，说明响应体开头混入了 HTML、空白或 PHP 错误信息（比如 Notice 输出到了 JSON 前面）。
立即学习“PHP免费学习笔记（深入）”；
- 关闭所有调试输出：确保控制器里没有
var_dump、print_r、echo等调试语句，哪怕它们被注释了——有些 IDE 插件会自动补全并激活 - 检查是否有 BOM 头：UTF-8 文件开头多了不可见字节，会让
json()前多出几个字符，用编辑器转成「UTF-8 无 BOM」格式 - 确认没加载额外视图或 layout：有些同学在控制器末尾写了
return view()又改成json()，但忘了删掉前面的$this->fetch()调用
