Flutter RiverPod Notifier无法更新AsyncValue列表，UI不刷新求助

问题场景 #

使用RiverPod Notifier实现列表管理时，初始空列表能正常在ListView显示，但调用addFestival方法添加元素后，UI无任何变化。addFestival内的print语句显示state已正确更新为旧列表+新元素，但ConsumerWidget中的print始终输出初始空列表。

相关代码 #

Provider代码（joined_festivals.dart）

import 'package:riverpod_annotation/riverpod_annotation.dart';
import 'package:findyourevent/models/festival/festival.dart';

part 'joined_festivals.g.dart';

@riverpod
class JoinedFestivals extends _$JoinedFestivals {
  @override
  Future<List<Festival>> build() async {
    return [];
  }

  void addFestival(Festival festival) async {
    final previousState = await future;
    state = AsyncValue.data([...previousState, festival.copyWith()]);
    print(state);
    ref.notifyListeners(); // 冗余的手动通知
  }
}

ListView代码（my_schedule.dart）

import 'package:hooks_riverpod/hooks_riverpod.dart';

class MySchedule extends ConsumerWidget {
  const MySchedule({super.key});

  @override
  Widget build(BuildContext context, WidgetRef ref) {
    final AsyncValue<List<Festival>> joinedFestivals =
        ref.watch(joinedFestivalsProvider);
    print(joinedFestivals.value);
    return switch (joinedFestivals) {
      AsyncData(:final value) => Padding(
          padding: const EdgeInsets.symmetric(horizontal: 10),
          child: ListView.builder(
            shrinkWrap: true,
            padding: const EdgeInsets.only(top: 10),
            itemCount: value.length,
            itemBuilder: (context, index) => FestivalCard(
              openFestival: () => Navigator.push(
                  context,
                  MaterialPageRoute(
                      builder: (context) =>
                          FestivalInformation(festival: value[index]))),
              festival: value[index],
            ),
          ),
        ),
      AsyncError() =>
        const Center(child: Text('Oops, something unexpected happened')),
      _ => const Center(child: CircularProgressIndicator()),
    };
  }
}

核心问题与修复步骤 #

1. 移除冗余的手动通知
   RiverPod的Notifier在更新state时会自动触发监听者重建，手动调用ref.notifyListeners()属于多余操作，可能干扰内部通知逻辑，直接删除该行代码。

2. 优化state更新逻辑
   原代码使用await future获取当前状态存在潜在风险（比如状态在等待期间发生变化），改用state.whenData直接基于当前状态更新，逻辑更简洁安全：

void addFestival(Festival festival) {
  state = state.whenData((previousState) => [...previousState, festival.copyWith()]);
}

3. 重新生成RiverPod代码
   运行以下命令重新生成provider的代码文件，避免代码生成不完整导致的状态监听异常：

dart run build_runner build --delete-conflicting-outputs

4. 确保Festival类的不可变性与相等性判断
   保证Festival类为不可变类（所有属性为final），并正确重写==和hashCode方法，确保RiverPod能正确判断列表元素的变化：

class Festival {
  final String id;
  final String name;
  // 其他属性

  Festival({required this.id, required this.name});

  Festival copyWith({String? id, String? name}) {
    return Festival(
      id: id ?? this.id,
      name: name ?? this.name,
    );
  }

  @override
  bool operator ==(Object other) =>
      identical(this, other) ||
      other is Festival &&
          runtimeType == other.runtimeType &&
          id == other.id &&
          name == other.name;

  @override
  int get hashCode => id.hashCode ^ name.hashCode;
}

5. 检查Provider作用域一致性
   确认调用addFestival的位置和MySchedule组件处于同一个ProviderScope中，若在对话框、新页面等场景使用了独立的ProviderScope，会导致状态更新无法同步到根作用域的监听者。

验证修复 #

修改完成后重新运行应用，调用addFestival方法后：

• 检查MySchedule中的print语句是否输出更新后的列表
• ListView应自动刷新并显示新添加的FestivalCard

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