Android集成IP2Location.io SDK遇HttpRequest类找不到错误求助

核心原因分析 #

java.net.http.HttpRequest 是Java 11新增的API，而Android直到**API 31（Android 12）**才原生支持这个包。你的项目运行时触发NoClassDefFoundError，本质是当前项目的最小SDK版本低于31，系统无法找到该类。

方案1：升级项目API级别（直接解决依赖问题） #

如果业务允许放弃Android 11及以下版本的支持，可直接升级项目API级别：

1. 打开Module级别的build.gradle（或build.gradle.kts）文件
2. 修改defaultConfig中的配置：

   android {
       defaultConfig {
           minSdkVersion 31
           targetSdkVersion 34 // 建议使用最新稳定API级别
           // 其他原有配置保留
       }
   }
   

3. 同步项目后重新运行

方案2：绕过官方SDK，直接调用REST API（兼容低版本Android） #

IP2Location.io提供了REST接口，无需依赖官方SDK即可实现查询，完全避免Java 11 API的兼容性问题：

1. 添加HTTP客户端依赖（以OkHttp为例），在Module的build.gradle中加入：

   dependencies {
       implementation 'com.squareup.okhttp3:okhttp:4.12.0'
   }
   

2. 编写IP查询代码：

   import okhttp3.Call;
   import okhttp3.Callback;
   import okhttp3.OkHttpClient;
   import okhttp3.Request;
   import okhttp3.Response;
   import org.json.JSONObject;
   import java.io.IOException;
   
   // 在非主线程中执行网络请求
   new Thread(() -> {
       OkHttpClient client = new OkHttpClient();
       String apiKey = "你的IP2Location.io密钥";
       String targetIp = "8.8.8.8";
       String url = String.format("https://api.ip2location.io/?key=%s&ip=%s", apiKey, targetIp);
   
       Request request = new Request.Builder().url(url).build();
       client.newCall(request).enqueue(new Callback() {
           @Override
           public void onFailure(Call call, IOException e) {
               e.printStackTrace();
               // 处理请求失败逻辑
           }
   
           @Override
           public void onResponse(Call call, Response response) throws IOException {
               if (response.isSuccessful() && response.body() != null) {
                   String jsonStr = response.body().string();
                   JSONObject result = new JSONObject(jsonStr);
                   // 解析所需字段，例如国家名称
                   String countryName = result.getString("country_name");
                   // 切换到主线程更新UI
                   runOnUiThread(() -> {
                       // 处理查询结果
                   });
               }
           }
       });
   }).start();
   

方案3：尝试兼容库（不推荐） #

由于官方SDK硬依赖Java 11的java.net.http包，目前没有成熟的兼容库能直接让低版本Android支持该API，强行引入第三方HTTP类无法替换SDK内部的依赖逻辑，因此不建议尝试。

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