Flutter APK安装后文章页面无数据显示问题排查与解决

核心差异分析 #

表单页面POST请求正常，文章页面GET请求失败，说明问题大概率出在请求方式/协议差异、API地址可达性、请求参数/头缺失或打包配置限制这几个方向，逐一排查：

1. 明文HTTP访问限制（Android 9+） #

如果你的Article API用的是http://协议，而表单API是https://，Android 9及以上系统默认会阻止明文HTTP请求，这是最常见的原因。

• 修复方法：
  1. 在android/app/src/main/res/xml目录下创建network_security_config.xml，内容如下：

     <?xml version="1.0" encoding="utf-8"?>
     <network-security-config>
         <base-config cleartextTrafficPermitted="true" />
     </network-security-config>
     

  2. 在AndroidManifest.xml的<application>标签中添加配置：

     <application
         ...
         android:networkSecurityConfig="@xml/network_security_config">
     

  或者直接将Article API升级为HTTPS协议（推荐长期方案）。

2. API地址不可达 #

如果Article API用的是localhost或本地局域网IP（如192.168.x.x），调试时模拟器能访问，但真实设备不在同一局域网就会失败；而表单API用的是公网地址，所以正常。

• 修复方法：
  • 将Article API地址替换为公网可访问的域名/IP；
  • 如果仅用于测试，确保设备和API服务器在同一Wi-Fi下，使用服务器的局域网IP（不要用localhost，换成服务器真实的内网IP）。

3. 请求参数/头缺失或格式错误 #

对比文章页面和表单页面的请求代码，检查以下点：

• 文章页面的GET请求是否漏传了必要的请求头（如Token、User-Agent）；
• 参数格式是否正确（比如日期参数月份的格式是否符合API要求）；
• 开启错误日志排查：在请求的catch块中打印错误信息，然后通过adb logcat查看设备日志，定位具体错误（比如403权限拒绝、404资源不存在）。
  示例代码（Dio为例）：

  try {
    final response = await dio.get('/articles');
    // 处理数据
  } catch (e) {
    print('文章请求错误: $e'); // 打印错误
  }
  

4. ProGuard混淆导致请求失败 #

如果开启了代码混淆，可能网络请求库或文章模型类被混淆，导致解析失败或请求无法发送。

• 修复方法：
  在android/app/proguard-rules.pro中添加混淆豁免规则，比如：

  # 保护自定义文章模型类
  -keep class com.your_app_package.models.Article { *; }
  # 保护网络请求库（以Dio为例）
  -keep class com.dio.** { *; }
  # 如果用Retrofit
  -keep class retrofit2.** { *; }
  -keepattributes Signature
  -keepattributes Exceptions
  

5. API端访问限制 #

检查Article API的服务器日志，确认是否收到了请求：

• 如果请求未到达服务器：回到前面的网络配置/地址问题；
• 如果请求到达但返回错误（如403、401）：说明API对请求来源、权限有限制，需要调整API配置或在请求中添加必要的验证信息。

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