ThinkPHP项目调用腾讯地图API报错主因是请求链路配置错误：Key未启用或未绑定域名/IP、接口未开通、坐标系非GCJ-02、未处理HTTP状态码及status=0校验、超时/限流/网络等问题。
检查 API Key 是否有效且已开通服务
腾讯地图控制台必须同时满足三项才可能成功：
- API Key 已创建，并处于“启用”状态
- 对应 Key 已绑定你部署的域名（H5 页面）或 IP（后端直调）——本地开发用 localhost 或 127.0.0.1 需单独加白名单
- 调用的接口（如逆地理编码、地点搜索）已在该 Key 的“启用服务”列表里勾选
确认坐标系与参数格式是否匹配
腾讯地图默认使用 GCJ-02 坐标系（国测局加密坐标），不是 WGS84（GPS 原始坐标）。如果你传的是高德/百度导出的坐标、或 GPS 设备原始经纬度，大概率会返回“INVALID_PARAMETER”或定位漂移。
解决办法：
- 前端用微信 JS-SDK 或 uni-app 的
uni.getLocation获取坐标时，指定type: 'gcj02' - 后端若用 PHP 自行构造请求，确保传入的
location=纬度,经度是 GCJ-02 格式；如不确定，先用腾讯地图官网的“坐标拾取器”验证一下
注意 HTTP 请求细节和响应兜底
报错常出现在代码层面，而非地图平台侧：
立即学习“PHP免费学习笔记（深入）”；
- 未设置超时（
timeout），导致请求卡住或被 Nginx 中断 - 没处理 HTTP 状态码（如 403、502）和腾讯返回的
status字段（0才表示成功，其他如300是配额超限，110是 key 无效） - 没做缓存，高频请求地址转坐标 → 触发限流 → 返回 403 或空响应 → 后续距离计算崩掉
建议用 Guzzle 封装请求，并统一拦截非 0 status：
示例片段（ThinkPHP 6 中）：if ($res['status'] !== 0) { throw new \Exception('腾讯地图API失败：' . $res['message'] ?? '未知错误'); }
常见报错对照速查
看到这些提示，基本可锁定方向：
- 403 Forbidden → Key 未授权 / 域名/IP 未白名单 / 服务未开通
- status=300 → 当日调用量超限（免费版 10 万次/日，注意是“调用次数”，不是“成功次数”）
- status=110 → Key 错误或已禁用
-
status=102 → 请求参数缺失（如少传
key或location） -
空白响应或 cURL error 7 → DNS 解析失败或网络不通，检查服务器能否访问
https://apis.map.qq.com
