PHP使用Maxmind GeoIP2查询IP报AddressNotFoundException如何处理

问题根因 #

GeoIp2\Exception\AddressNotFoundException 是Maxmind GeoIP2库预设的合法异常，当查询的IP未被收录在当前使用的GeoIP2数据库版本中时就会抛出，属于预期内的异常，必须主动捕获处理才能避免脚本终止。

具体修改步骤 #

1. 引入异常类 #

在调用GeoIP2逻辑的PHP文件头部，先导入对应的异常类，避免命名空间报错：

use GeoIp2\Exception\AddressNotFoundException;

2. 给GeoIP查询逻辑加try-catch捕获 #

如果你已经封装了Geo查询函数

假设你原来的查询函数逻辑如下：

// 原代码示例，可替换为你自己的实际逻辑
function queryGeoByIp(string $ip, $geoReader) {
    return $geoReader->city($ip);
}

修改后代码：

function queryGeoByIp(string $ip, $geoReader) {
    try {
        // 原有正常查询逻辑不变
        return $geoReader->city($ip);
    } catch (AddressNotFoundException $e) {
        // IP不在数据库中的兜底逻辑，返回和正常查询结构一致的默认值即可
        // 可选：在这里加日志记录未匹配的IP，方便后续排查
        // error_log("GeoIP未匹配IP：{$ip}，错误信息：" . $e->getMessage());
        return (object)[
            'country' => (object)['isoCode' => 'UNKNOWN', 'name' => '未知'],
            'city' => (object)['name' => '未知'],
            // 其他你用到的字段，保持结构和正常返回一致即可
        ];
    } catch (\Exception $e) {
        // 兜底捕获其他所有GeoIP相关异常，比如数据库文件损坏、权限不足等
        error_log("GeoIP查询出错：{$ip}，错误信息：" . $e->getMessage());
        return (object)[
            'country' => (object)['isoCode' => 'UNKNOWN', 'name' => '未知'],
            'city' => (object)['name' => '未知'],
        ];
    }
}

如果你没有封装函数，直接在业务逻辑里调用

直接在你调用$geoReader->city($ip)的代码外层套try-catch即可，逻辑和上面完全一致。

3. SQL拼接逻辑适配 #

修改后查询函数已经统一了正常和异常场景的返回结构，你原来的SQL拼接逻辑不需要改动，直接使用查询返回的字段拼接即可，不会因为异常打断后续执行流程。

测试验证 #

使用测试IP 12.34.56.78 调用修改后的逻辑，不会再触发致命错误，脚本会正常执行后续的SQL写入等流程。

内容的提问来源于stack exchange，提问作者user16903911