Flutter Text调用异步函数显示Instance of Future<dynamic>如何解决

出现Instance of 'Future'<dynamic>显示的核心原因有两个：

• 所有带async关键字的函数，返回值默认都是Future类型，你直接调用getData().toString()时，拿到的不是函数内部查询到的用户名，是Future异步对象本身，打印出来自然就是对象的实例类型描述。
• 你写的getData函数没有返回任何值，仅做了print操作，就算异步执行完成，外部也拿不到你要的displayName数据，而且FirebaseAuth.instance.currentUser本身是同步属性，不需要加await等待。

根据你的需求，推荐两种实现方式，优先选第二种更简单：

方式1：直接同步取值（最适配当前场景） #

FirebaseAuth.instance.currentUser是可以直接访问的同步属性，不需要写异步函数，直接在Text中取值即可：

Text(
  // 如果用户未登录，displayName为null，就显示默认的"未登录"文案
  FirebaseAuth.instance.currentUser?.displayName ?? "未登录"
)

方式2：使用FutureBuilder处理异步场景 #

如果你后续需要搭配其他异步逻辑（比如等待Firebase Auth初始化完成再拿用户信息），就修正异步函数，配合FutureBuilder做异步渲染：
首先修正getData函数，明确返回值：

// 明确返回Future<String?>类型，返回获取到的用户名
Future<String?> getData() async {
  // 如果需要等待auth状态初始化完成再取值，可以放开下面这行注释
  // await FirebaseAuth.instance.authStateChanges().first;
  User? user = FirebaseAuth.instance.currentUser;
  return user?.displayName;
}

然后在组件树中用FutureBuilder包裹Text组件，等待异步结果返回后再渲染内容：

FutureBuilder<String?>(
  future: getData(),
  builder: (context, snapshot) {
    // 等待加载时显示占位文案
    if (snapshot.connectionState == ConnectionState.waiting) {
      return const Text("加载中...");
    }
    // 异步完成后显示用户名，无数据则显示未登录
    final userName = snapshot.data ?? "未登录";
    return Text(userName);
  },
)

• 不要直接在Text这类需要同步值的组件里直接调用异步函数，异步结果不会同步返回，必须用FutureBuilder（处理单次异步请求）或者StreamBuilder（处理持续流数据）这类专门的异步组件来渲染动态内容。
• 编写async函数时一定要明确标注返回值类型，不要使用默认的dynamic返回值，能减少很多这类取值错误。

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