Flutter异步函数无法从API获取数据求助

从以下几个方向逐一排查定位问题：

1. 确认网络权限配置 #

• Android：在android/app/src/main/AndroidManifest.xml中添加网络权限：

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

• iOS：若使用HTTP协议（非HTTPS），需在ios/Runner/Info.plist中添加非安全网络访问许可：

<key>NSAppTransportSecurity</key>
<dict>
    <key>NSAllowsArbitraryLoads</key>
    <true/>
</dict>

2. 验证API地址与返回格式 #

• 直接在浏览器或Postman中访问Config.apiURL，确认：
  • 地址可正常访问，返回状态码为200
  • 返回内容是JSON数组（如[{"id":1}, {"id":2}]）。若返回的是嵌套在对象里的数组（如{"data": [{"id":1}]}），需修改ApiService的解析逻辑：

// 适配嵌套格式的返回数据
Map<String, dynamic> responseMap = jsonDecode(response.body);
List<dynamic> data = responseMap['data'] as List<dynamic>;

3. 完善错误捕获与日志输出 #

修改Widget中的getData方法，添加错误捕获并打印详细异常：

void getData() async {
  debugPrint('entrance');
  try {
    userDataList = await ApiService().getData();
    debugPrint(userDataList.toString());
    // 若需更新UI，必须调用setState触发重绘
    setState(() {});
  } catch (e) {
    debugPrint('数据获取失败: $e');
  }
}

同时优化ApiService的异常处理，打印具体错误信息：

catch (e) {
  debugPrint('API请求异常详情: $e');
  throw Exception("Failed to fetch data..");
}

4. 确认异步数据后的UI更新逻辑 #

如果需要将获取到的数据展示在UI上，必须在数据赋值后调用setState，否则Widget不会重新渲染。

5. 检查设备网络环境 #

确认测试用的模拟器/真机可正常访问外网，无代理或防火墙拦截API请求。

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