在ThinkPHP模型的beforeWrite事件中自动解析地址为经纬度：清洗address字段、拼接城市补全、调用高德/百度API（超时5秒、状态校验）、GCJ-02转WGS-84（仅成功时）、限流去重缓存，失败静默降级。
ThinkPHP 模型 save() 时如何自动解析地址字段为经纬度
直接在模型的 save() 或 update() 流程中注入解析逻辑，而不是靠控制器手动调用。关键是在模型的 beforeWrite 事件里做——它在数据写入前触发，且能修改即将入库的字段值。
- 把原始地址存在
address字段，经纬度存到lat和lng字段，模型里定义protected $autoWrite = ['lat', 'lng']; - 在模型类中重写
beforeWrite()方法，检查$data['address']是否变化（避免无意义重复调用高德/百度 API） - 调用第三方地理编码接口后，必须判断返回状态：高德返回
"status":0，百度是"status":0，其他值（如1、300）一律跳过写入，否则会把null或默认值存进去 - 注意设置超时和重试：API 调用建议设
timeout=5，失败时不抛异常，而是记录日志并保留原lat/lng值
为什么不能在 create() 或 new Model() 时就解析地址
因为 create() 已被废弃，而 new Model($data) 构造时数据尚未校验或过滤，address 可能为空、含 HTML 标签、或只是“北京市”，这类输入直接送进地理编码接口大概率返回失败或模糊坐标。
- 真实场景中，用户提交的地址常带换行、空格、括号等干扰字符，需先用
trim()+str_replace()清洗 - 部分地址（如“朝阳大悦城”）需要补全城市信息才能准确定位，建议拼接成
$data['address'] . ' ' . ($data['city'] ?? '北京市') - 如果在构造阶段强行解析，一旦接口失败，对象创建失败，整个表单提交流程中断；而在
beforeWrite中失败可静默降级，不影响主流程
高德 API 返回坐标精度不够？ThinkPHP 怎么处理 offset 偏移
高德对国内地址返回的坐标普遍有 50–200 米偏移（GCJ-02 坐标系），若业务要求与地图 SDK 显示一致，无需纠偏；但若对接的是 WGS-84 设备（如某些 GPS 终端），则必须转换。
- 别自己手写火星坐标转换算法，误差大且维护难；用现成 Composer 包，如
overtrue/geotools（支持 GCJ-02 ↔ WGS-84） - 转换必须放在地理编码之后、存库之前，且只对成功解析的结果操作，避免对
null坐标调用转换函数导致报错 - ThinkPHP 模型中不要在
afterWrite里反查更新——这会引发二次写库，应直接在beforeWrite中完成清洗 → 解析 → 转换 → 赋值整条链路
批量导入 Excel 地址时，怎么避免请求被高德限流
高德免费版 QPS 限制为 1，连续调用必触发 "infocode":10009 错误。批量场景下必须主动限流，不能依赖 try-catch 硬扛。
- 用
usleep(1000000)（即 1 秒）控制间隔，比sleep(1)更精准，避免 PHP-FPM 进程阻塞 - 导入前先用
array_unique()去重地址，相同地址只查一次，结果缓存到runtime/cache/geo_*.php文件中（注意加锁） - 若某地址多次解析失败（如返回
"count":0），记录到log/geo_fail.log，后续人工核对，不要无限重试
真正麻烦的是地址表述不规范——“国贸三期B座”和“朝阳区建国门外大街1号国贸三期B座”可能返回不同坐标。业务上得接受这种不确定性，别指望一次解析就 100% 精确。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
