使用riverpod_annotation生成AsyncNotifierProvider.family时遇Family类不存在错误

问题根源 #

这个错误的核心原因是Riverpod依赖版本不兼容或生成代码缺少必要的Riverpod核心包导入，导致生成的Family基类无法被识别。此外，你的控制器代码存在几处需要调整的细节，会影响代码生成和运行逻辑。

解决步骤 #

1. 确保依赖版本兼容 #

在pubspec.yaml中锁定兼容的Riverpod生态版本，推荐使用最新稳定版：

dependencies:
  flutter:
    sdk: flutter
  riverpod: ^2.3.0
  riverpod_annotation: ^2.2.0
  pocketbase: ^0.18.0

dev_dependencies:
  flutter_test:
    sdk: flutter
  build_runner: ^2.4.4
  riverpod_generator: ^2.3.0

执行flutter pub get更新依赖。

2. 修正控制器代码 #

调整代码中的类型缺失、状态更新逻辑和实例获取方式：

import 'package:front_end/utils/pocketbase_provider.dart';
import 'package:pocketbase/pocketbase.dart';
import 'package:riverpod_annotation/riverpod_annotation.dart';
part 'mangage_topic_voices_controller.g.dart';

@riverpod
class ManageTopicVoicesController extends _$ManageTopicVoicesController {
  List<String> _selectedVoices = [];
  bool mounted = true;

  // 明确返回类型
  List<String> get selectedVoices => _selectedVoices;

  @override
  FutureOr<void> build({required List<String> ids}) {
    ref.onDispose(() {
      mounted = false;
    });
    if (mounted) {
      _selectedVoices = ids;
    }
  }

  void addVoice(String id) {
    _selectedVoices = [..._selectedVoices, id];
    // 更新state触发UI刷新
    state = AsyncData(null);
  }

  void removeVoice(String id) {
    _selectedVoices = _selectedVoices.where((e) => e != id).toList();
    // 更新state触发UI刷新
    state = AsyncData(null);
  }

  // 补全参数类型，通过ref获取PocketBase实例
  Future<RecordModel> updateTopic({required String topicId, required List<String> selectedVoices}) async {
    final pb = ref.watch(pbProvider);
    final res = await pb
        .collection('topics')
        .update(topicId, body: {"voices": selectedVoices});

    return res;
  }
}

3. 重新生成代码 #

先清理旧的生成文件，再重新执行代码生成命令：

dart run build_runner clean
dart run build_runner build --delete-conflicting-outputs

4. 检查生成文件的导入 #

如果生成的.g.dart文件顶部没有以下导入，手动添加：

import 'package:riverpod/riverpod.dart';

关键说明 #

• Family是Riverpod内部用于处理带参数Provider的基类，版本不兼容会导致生成代码无法识别该类。
• 控制器中修改_selectedVoices后必须更新state，否则UI无法感知数据变化。
• 不能直接使用全局pb实例，通过ref.watch(pbProvider)获取是Riverpod的标准用法，避免上下文错误。

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