Codename One前端搭配Spring Boot后端APK网络连接异常问题

核心问题分析 #

本地模拟器与真机的网络环境存在本质差异：模拟器可直接访问本地Spring Boot服务，但真机处于移动网络或局域网时，会因网络可达性、权限配置、地址配置三类问题导致网络请求失败。

1. 确保Spring Boot服务可被真机访问 #

• 修改Spring Boot的application.properties，将服务绑定到全局IP，而非仅本地回环地址：

  server.address=0.0.0.0
  server.port=你的服务端口号
  

• 确认真机与Spring Boot服务器处于同一局域网（或服务已部署到公网），用真机浏览器访问http://服务器局域网IP:端口/接口路径，验证服务是否能正常响应。

2. 检查Codename One的Android网络权限 #

• 在项目的codenameone_settings.properties中，添加必要的网络权限：

  android.xpermissions=<uses-permission android:name="android.permission.INTERNET"/>
  android.xpermissions=<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
  

• 针对Android 6.0+（API 23+），需动态申请网络权限：

  if (Display.getInstance().checkPermission(Permission.INTERNET)) {
      // 执行网络请求逻辑
  } else {
      Display.getInstance().requestPermission(Permission.INTERNET, () -> {
          // 权限申请通过后的处理
      });
  }
  

3. 修正目标URI的地址配置 #

• 模拟器中使用的http://localhost:端口仅本地有效，真机需替换为服务器的实际局域网IP或公网域名，避免硬编码本地地址：

  // 错误写法（仅模拟器可用）
  String baseUrl = "http://localhost:8080/api";
  // 正确写法（真机可用）
  String baseUrl = "http://192.168.1.100:8080/api"; // 替换为你的服务器局域网IP
  // 或公网域名
  String baseUrl = "https://your-public-domain.com/api";
  

4. 排查HTTPS证书问题（若使用） #

• 若Spring Boot使用HTTPS且用自签名证书，真机默认会拒绝信任，测试阶段可临时允许无效证书（生产环境需配置合法CA证书）：

  ConnectionRequest cr = new ConnectionRequest() {
      @Override
      protected void handleErrorResponseCode(int code, String message) {
          // 处理证书相关错误
      }
  };
  cr.setUrl(baseUrl);
  cr.setAllowInvalidSSL(true); // 仅测试用
  

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