Flutter Riverpod：手动编写的StateNotifier无法通知状态变更

问题根源 #

你遇到的问题核心是直接修改了从ref.watch获取的状态对象实例，然后将同一个实例传递给setState。StateNotifier内部会通过==比较新旧状态是否相等，由于你传递的是同一个对象（即使内部属性已修改），==返回true，因此StateNotifier不会通知监听者（ConsumerWidget）触发UI更新。

解决步骤 #

1. 给NotificationsSettings添加copyWith方法

copyWith是不可变状态对象的标准实现方式，用于基于当前实例创建新实例，同时修改指定属性：

class NotificationsSettings {
  bool? enabled;
  int? timeoutInDays;
  int? delayInHours;
  String? startTime;

  // 保留原有构造函数、fromJson、toJson、==、hashCode 代码

  // 添加copyWith方法
  NotificationsSettings copyWith({
    bool? enabled,
    int? timeoutInDays,
    int? delayInHours,
    String? startTime,
  }) {
    return NotificationsSettings(
      enabled: enabled ?? this.enabled,
      timeoutInDays: timeoutInDays ?? this.timeoutInDays,
      delayInHours: delayInHours ?? this.delayInHours,
      startTime: startTime ?? this.startTime,
    );
  }
}

2. 修改UI层的状态更新逻辑

禁止直接修改原有状态对象，改用copyWith创建新实例后再传递给Notifier：

onToggle: (index) {
  // 基于当前状态创建新实例，修改enabled属性
  final newSettings = notificationsSettings.copyWith(
    enabled: index == 0,
  );
  // 将新实例传递给notifier更新状态
  ref.read(notificationsProvider.notifier).setState(newSettings);
}

（可选）优化StateNotifier的更新方法

为了更贴合StateNotifier的设计规范，建议在Notifier中添加针对性的更新方法，而非通用的setState：

class NotificationsSettingsStateNotifier extends StateNotifier<NotificationsSettings> {
  NotificationsSettingsStateNotifier() : super(NotificationsSettings.defaultValues());

  // 替换通用setState，添加精准的更新方法
  void toggleEnabled(bool enabled) {
    state = state.copyWith(enabled: enabled);
  }

  // 可扩展其他更新方法
  void updateTimeout(int days) {
    state = state.copyWith(timeoutInDays: days);
  }
}

UI层调用会更简洁：

onToggle: (index) {
  ref.read(notificationsProvider.notifier).toggleEnabled(index == 0);
}

关键说明 #

• 你重写==和hashCode的做法是正确的，这是StateNotifier判断不同实例状态是否变化的基础。
• StateNotifier的设计依赖不可变状态更新：必须通过替换整个状态实例来触发更新，直接修改原有实例的属性属于可变更新，不符合其触发逻辑，因此不会通知UI刷新。

内容的提问来源于stack exchange，提问作者Yuriy N.