Flutter使用Riverpod的ChangeNotifierProvider状态更新后UI未刷新问题

1. 确认ChangeNotifier修改状态后调用notifyListeners() #

这是最高发的问题，用户状态更新后必须手动触发通知，Riverpod才会感知状态变化触发组件重载。
错误示例：

class UserNotifier extends ChangeNotifier {
  UserModel? user;
  Future<void> fetchUser(String uid) async {
    user = await UserProxy().getUser(uid);
    // 缺少notifyListeners()
  }
}

正确写法：

class UserNotifier extends ChangeNotifier {
  UserModel? user;
  Future<void> fetchUser(String uid) async {
    user = await UserProxy().getUser(uid);
    notifyListeners(); // 必须加这行通知状态变更
  }
}

2. 修正表单字段赋值逻辑 #

TextFormField的initialValue仅在组件首次挂载时生效，后续接口返回数据后不会自动更新。你需要为每个表单字段绑定TextEditingController，在拿到用户数据后手动给控制器赋值：

// 页面组件里定义控制器
final _usernameController = TextEditingController();

// 监听provider状态变化时更新控制器
final userState = ref.watch(userProvider(uid));
if(userState?.username != null) {
  _usernameController.text = userState!.username;
}

// 表单字段绑定控制器
TextFormField(
  controller: _usernameController,
  // 不要依赖initialValue实现动态更新
)

3. 确认组件中使用watch监听provider状态 #

如果你在组件中用了ref.read去获取provider状态，状态变化时不会触发组件重载，必须用ref.watch：

// 正确写法，状态变化会触发当前组件重新build
final user = ref.watch(userProvider(uid));

// 错误写法，仅读取一次最新状态，不会响应后续更新
// final user = ref.read(userProvider(uid));

4. 确认family provider参数匹配 #

你使用了带用户ID参数的family provider，要保证监听时传入的用户ID和调用fetch接口时的参数完全一致，否则会生成独立的provider实例，状态无法同步。

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