Flutter代码运行正常但调试控制台报Unexpected null value错误求助

错误原因 #

问题出在FutureBuilder的builder回调逻辑里：

• FutureBuilder会在异步任务的不同阶段多次触发builder：初始阶段（异步任务还在执行）时，snapshot.data是null，但你直接用snapshot.data!强制解包空值，这就导致了调试控制台反复抛出Unexpected null value错误。
• 虽然异步任务完成后data有值，界面能正常显示，但加载过程中的空值解包错误已经被触发。

解决方案 #

必须在builder中先判断异步任务的状态，处理加载中、错误、数据就绪的不同场景，避免直接强制解包null值。

修正后的核心代码 #

body: FutureBuilder<String>(
  future: _getDataFromWeb(),
  builder: (context, snapshot) {
    // 处理加载中状态
    if (snapshot.connectionState == ConnectionState.waiting) {
      return const Center(child: CircularProgressIndicator());
    }
    // 处理错误状态
    if (snapshot.hasError) {
      return Center(child: Text('加载失败: ${snapshot.error}'));
    }
    // 确保数据非空再处理
    if (!snapshot.hasData) {
      return const Center(child: Text('无数据'));
    }

    Map jsonMap = json.decode(snapshot.data!);

    return GridView.builder(
      gridDelegate:
          SliverGridDelegateWithFixedCrossAxisCount(crossAxisCount: 2),
      itemCount: jsonMap['count'],
      itemBuilder: (BuildContext c, int i) {
        Map resultItem = jsonMap['result'][i];

        return Card(
          child: Center(child: Text("${resultItem['name']}"))
        );
      },
    );
  },
),

额外优化建议 #

不要在build方法中直接调用_getDataFromWeb()，因为build会被多次触发，每次都会重新发起异步请求。建议把异步任务的初始化放在initState中：

late Future<String> _dataFuture;

@override
void initState() {
  super.initState();
  // 仅在初始化时发起一次请求
  _dataFuture = _getDataFromWeb();
}

// 后续FutureBuilder使用这个预初始化的Future
body: FutureBuilder<String>(
  future: _dataFuture,
  builder: (context, snapshot) {
    // ...上述状态判断逻辑
  },
),

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