Flutter中当前登录用户资料无法在TextField显示的问题求助

可能的问题原因 #

• TextEditingController未初始化：代码仅定义了email控制器，username和phone控制器未声明初始化，直接调用username.text会触发报错。
• Firebase Auth状态未同步：initState中直接调用getUserData()时，FirebaseAuth.instance.currentUser可能还未完成状态同步，强制解包!会引发空指针异常或无法获取用户ID。
• Firestore文档/字段异常：
  • 强制解包docSnapshot.data()!，若Firestore中对应用户ID的文档不存在，会直接崩溃；
  • 代码中使用的字段名（如username、phone）可能与Firestore实际存储的字段名不匹配（比如大小写差异：UserName vs username）。
• 缺乏错误处理：异步获取数据过程中未添加异常捕获，无法定位请求失败的具体原因。
• TextField配置冗余：hintText绑定${username.text}无意义，TextField会自动显示控制器的text值，初始为空时hintText才会显示，无需动态绑定。

解决方案 #

1. 补全控制器初始化 #

在State类中声明并初始化所有需要的TextEditingController：

TextEditingController email = TextEditingController();
TextEditingController username = TextEditingController(); // 新增
TextEditingController phone = TextEditingController(); // 新增
Profile? profileModel;
User? user;

2. 安全处理Auth用户获取 #

避免强制解包，先判断用户状态再执行数据获取：

Future<void> getUserData() async {
  final userData = FirebaseAuth.instance.currentUser;
  if (userData == null) {
    // 用户未登录，可跳转登录页或给出提示
    return;
  }
  
  try {
    var collection = FirebaseFirestore.instance.collection('users');
    var docSnapshot = await collection.doc(userData.uid).get();
    
    if (!docSnapshot.exists) {
      // 文档不存在，提示用户完善资料
      return;
    }
    
    Map<String, dynamic> data = docSnapshot.data()!;
    setState(() {
      email.text = data['email'] ?? ''; // 添加空值判断，避免空指针
      username.text = data['username'] ?? '';
      phone.text = data['phone'] ?? '';
    });
  } catch (e) {
    // 捕获异常并打印，方便排查问题
    print('获取用户资料失败: $e');
  }
}

3. 优化initState调用逻辑 #

使用addPostFrameCallback确保页面渲染完成后再获取数据，或监听Auth状态变化自动同步资料：

@override
void initState() {
  super.initState();
  // 等待页面首次渲染完成后执行数据获取
  WidgetsBinding.instance.addPostFrameCallback((_) {
    getUserData();
  });
  
  // 可选：监听Auth状态，用户登录状态变化时自动更新资料
  FirebaseAuth.instance.authStateChanges().listen((User? user) {
    if (user != null) {
      getUserData();
    }
  });
}

4. 修正TextField配置 #

移除冗余的hintText动态绑定，改为静态提示文本：

TextFormField(
  controller: username,
  decoration: InputDecoration(
    labelStyle: TextStyle(color: Colors.black87),
    labelText: "Username",
    hintText: '请输入用户名', // 改为静态提示
    prefixIcon: Icon(
      Icons.perm_identity_outlined,
      color: Colors.grey.shade800,
    ),
  ),
),

5. 验证Firestore数据一致性 #

• 检查Firestore中users集合下的文档ID是否与用户UID完全一致；
• 确认文档内的字段名与代码中使用的完全匹配（注意大小写和拼写）。

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