使用JsonSerializable注解的StateProvider中ref.watch无法响应值变更

核心原因 #

Riverpod的StateProvider是通过检测状态对象的引用变化来触发Widget刷新的。你当前的操作是直接修改现有UserModel实例的intro属性，没有替换整个state对象——对象的内存引用没发生变化，Riverpod就会认为状态没有更新，自然不会通知依赖的Widget重建。

正确操作方式 #

方式1：直接创建新实例替换原状态

如果UserModel只有单个属性，直接生成新实例替换即可：

ElevatedButton(
  onPressed: () {
    ref.read(userP.notifier).state = UserModel('change!');
  },
  child: const Text('change intro')
)

方式2：给UserModel添加copyWith方法（多属性场景更优雅）

先修改UserModel类，添加用于复制实例并修改指定属性的方法：

@JsonSerializable()
class UserModel {
  String? intro;

  UserModel(this.intro);

  // 添加copyWith方法，保留原有属性的同时修改指定字段
  UserModel copyWith({String? intro}) {
    return UserModel(intro ?? this.intro);
  }

  factory UserModel.fromJson(Map<String, dynamic> json) => _$UserModelFromJson(json);
  Map<String, dynamic> toJson() => _$UserModelToJson(this);
}

然后更新状态时使用copyWith生成新实例：

ElevatedButton(
  onPressed: () {
    final currentUser = ref.read(userP);
    ref.read(userP.notifier).state = currentUser.copyWith(intro: 'change!');
  },
  child: const Text('change intro')
)

补充说明 #

所有基于不可变状态设计的状态管理工具（包括Riverpod、Bloc等），核心都是通过状态对象的不可变性来追踪变化。直接修改对象属性属于可变操作，会绕过状态监听机制，导致UI不刷新。必须通过生成新的状态对象来触发更新逻辑。

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