应使用 getAttr 而非 setAttr 实现 IP 地理位置自动解析，因 setAttr 会导致写入性能下降与事务风险；需定义 getAttrIpLocationAttr 方法，配合 IpLocationService 服务类封装解析逻辑，并添加空值、非法 IP 及异常返回的守卫机制。
ThinkPHP 模型字段自动解析 IP 为地理位置：用 getAttr 还是 setAttr？
不是所有字段都适合在模型里做自动解析，IP 转地理位置这种带外部依赖（如 HTTP 请求、数据库查询）的操作，必须放在读取时（getAttr）而非写入时（setAttr），否则会导致新增/更新数据变慢、事务失败、缓存污染。
-
setAttr:ip_location是错的——它会在每次save()时触发解析，但此时 IP 可能还没入库，或根本没改，纯属浪费 - 正确做法是定义
getAttr:ipLocation，仅当代码中访问$model->ip_location时才查一次，且可配合缓存控制频率 - 注意命名：方法名必须是
getAttr{FieldName}Attr格式，FieldName首字母大写，比如字段叫ip，想暴露为ip_location，方法就得叫getAttrIpLocationAttr
IP 地理位置解析函数不能直接写死在模型里
硬编码调用 file_get_contents("http://ip-api.com/json/...") 或直接连本地 GeoIP 库，会让模型失去可测试性、不可 mock、无法隔离网络异常。实际项目中应抽离为服务类。
- 新建
app/service/IpLocationService.php，封装解析逻辑，支持 fallback（如解析失败返回空数组）、超时控制、简单缓存（Cache::remember("ip_{$ip}", 3600, ...)） - 模型中通过
app()->make(IpLocationService::class)->resolve($this->ip)调用，避免 new 实例或静态调用 - 别在
getAttr方法里 try-catch 吞掉所有异常——至少 log 错误，否则 IP 字段莫名为空却查不到原因
字段值为空、非法 IP 或接口限流时怎么不崩模型？
真实场景下 $this->ip 可能是 null、'127.0.0.1'、'::1'、内网地址，或第三方接口返回 429，这些都会让解析中途退出，但模型属性不能因此报错或中断后续逻辑。
- 在
getAttrIpLocationAttr开头加守卫：if (empty($this->ip) || !filter_var($this->ip, FILTER_VALIDATE_IP)) { return []; } - 调用外部服务后检查返回结构，不要直接取
$data['country']，先 isset 再赋值，或用data_get($data, 'country', '') - ThinkPHP 6.1+ 支持在获取器中 throw 新异常，但别 throw
Exception，用自定义IpResolveException并在上层捕获，避免影响整个 JSON 输出
为什么不用数据库视图或冗余字段存地区信息？
看起来省事，其实埋了同步和一致性雷——IP 字段改了，地区字段未必跟着更新；批量导入时容易漏；搜索“来自北京的用户”会因地区字段滞后导致结果不准。
立即学习“PHP免费学习笔记（深入）”；
- 冗余字段只适用于变化极低、查询频次极高、且能保证原子更新的场景（比如用户注册时的国家码）
- IP 地理位置本身就不精确，且 API 数据随时可能更新，实时解析反而更可信
- 真要优化性能，用 Redis 缓存
ip → {country: "CN", city: "Beijing"}即可，过期时间设 1 小时足够，不必落库
最麻烦的从来不是写几行解析代码，而是处理那些“本不该出现但就是出现了”的 IP：私有地址、IPv6 兼容格式、CDN 透传失败的 X-Forwarded-For、甚至前端伪造的 header。别指望一次写完就稳，得留好日志入口和降级开关。
