Flutter/Riverpod：能否在一个StateNotifier中读取另一个？

一、解决StateNotifier中获取Ref调用ErrorProvider的问题 #

1. 让StateNotifier持有Ref实例 #

在定义业务相关的StateNotifier（比如OnboardingNotifier）时，修改构造函数接收并保存Ref对象，这样就能在方法内部读取全局的errorProvider：

class OnboardingNotifier extends StateNotifier<OnboardingState> {
  OnboardingNotifier(this.ref) : super(OnboardingState.initial());

  final Ref ref; // 保存Ref实例

  Future<void> submitUserInfo() async {
    try {
      // 执行业务逻辑，比如调用API
      await AuthApi.submitInfo(state.userInfo);
    } catch (e, stackTrace) {
      // 通过ref调用errorProvider更新错误状态
      ref.read(errorProvider.notifier).showError(
            message: e.toString(),
            stackTrace: stackTrace,
          );
    }
  }
}

对应的Provider定义需要在创建时把当前ref传递给StateNotifier：

final onboardingProvider = StateNotifierProvider<OnboardingNotifier, OnboardingState>((ref) {
  return OnboardingNotifier(ref); // 将ref传入StateNotifier构造函数
});

2. 封装通用错误处理逻辑 #

为了避免重复编写try-catch，可以给Ref扩展一个通用错误处理方法：

extension RefErrorHandler on Ref {
  void reportError(Object error, StackTrace stackTrace, {String? customMsg}) {
    read(errorProvider.notifier).showError(
      message: customMsg ?? error.toString(),
      stackTrace: stackTrace,
    );
  }
}

之后在StateNotifier里就能简化调用：

Future<void> submitUserInfo() async {
  try {
    await AuthApi.submitInfo(state.userInfo);
  } catch (e, stackTrace) {
    ref.reportError(e, stackTrace);
  }
}

二、更优的全局错误处理架构建议 #

1. 全局单点监听错误状态 #

不需要每个页面的基础Widget都监听ErrorNotifier，可以在应用根节点添加一个全局监听组件，统一处理错误弹窗：

class GlobalErrorHandler extends ConsumerWidget {
  const GlobalErrorHandler({required this.child, super.key});

  final Widget child;

  @override
  Widget build(BuildContext context, WidgetRef ref) {
    // 监听errorProvider的状态变化
    ref.listen<ErrorModel>(errorProvider, (prev, current) {
      if (current.showError) {
        showDialog(
          context: context,
          barrierDismissible: false,
          builder: (ctx) => AlertDialog(
            title: const Text('出错了'),
            content: Text(current.message),
            actions: [
              TextButton(
                onPressed: () {
                  Navigator.of(ctx).pop();
                  // 重置错误状态
                  ref.read(errorProvider.notifier).hideError();
                },
                child: const Text('确定'),
              ),
            ],
          ),
        );
      }
    });

    return child;
  }
}

在main.dart中挂载这个全局组件：

void main() {
  runApp(
    ProviderScope(
      child: GlobalErrorHandler(
        child: const MyApp(),
      ),
    ),
  );
}

2. 区分错误类型精细化处理 #

在ErrorModel中添加错误类型字段，针对网络错误、业务错误、未知错误等展示不同提示：

enum ErrorType { network, business, unknown }

class ErrorModel {
  final bool showError;
  final String message;
  final ErrorType type;
  final StackTrace? stackTrace;

  ErrorModel({
    required this.showError,
    required this.message,
    required this.type,
    this.stackTrace,
  });

  static ErrorModel initial() => ErrorModel(
        showError: false,
        message: '',
        type: ErrorType.unknown,
      );
}

在ErrorNotifier中根据类型处理，比如网络错误提示检查网络，业务错误展示具体业务信息。

3. API层统一拦截错误 #

如果是网络请求错误，可以在API封装层统一捕获，避免在每个StateNotifier中重复写try-catch。以Dio为例，添加拦截器：

class DioErrorInterceptor extends Interceptor {
  final Ref ref;

  DioErrorInterceptor(this.ref);

  @override
  void onError(DioException err, ErrorInterceptorHandler handler) {
    String msg;
    ErrorType type;

    switch (err.type) {
      case DioExceptionType.connectionTimeout:
      case DioExceptionType.connectionError:
        msg = '网络连接失败，请检查网络设置';
        type = ErrorType.network;
        break;
      case DioExceptionType.badResponse:
        msg = err.response?.data?['msg'] ?? '请求失败，请稍后重试';
        type = ErrorType.business;
        break;
      default:
        msg = '未知错误';
        type = ErrorType.unknown;
    }

    ref.read(errorProvider.notifier).showError(
          message: msg,
          type: type,
          stackTrace: err.stackTrace,
        );

    handler.reject(err);
  }
}

这样所有API请求的错误都会被统一拦截处理，大幅减少业务层的冗余代码。

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