如何包装Dart泛型类？gRPC服务Sentry埋点遇类型兼容问题

错误根源 #

你遇到的类型不兼容问题，本质是Dart泛型的不变性导致的：ServiceMethod<List<int>>无法直接赋值给ServiceMethod<dynamic>，因为泛型参数Q的类型不匹配。你之前用Wrapper<dynamic>包装原ServiceMethod时，构造函数需要的ServiceMethod<dynamic>与实际传入的ServiceMethod<List<int>>类型不兼容，触发了类型转换错误。

以下是两种可行的解决方案，分别适配不同场景：

方案一：动态参数兼容（无需修改调用代码） #

这种方案通过dynamic参数接收请求，利用Dart动态调用特性兼容所有类型，适合大规模自动生成的服务类场景，无需修改原有调用逻辑。

修改后的代码 #

class WrappingContainer extends Service {
  WrappingContainer(super.map);

  @override
  ServiceMethod? lookup(String name) {
    final original = super.lookup(name);
    if (original == null) return null;
    return Wrapper(original);
  }
}

class Wrapper extends ServiceMethod<dynamic> {
  final ServiceMethod _original;

  Wrapper(this._original) : super((dynamic request) {
    // --- 插入Sentry埋点逻辑 ---
    try {
      // 调用原始处理器
      _original.action(request);
    } catch (exception, stackTrace) {
      // 上报异常到Sentry
      // Sentry.captureException(exception, stackTrace: stackTrace);
      print('捕获异常并上报: $exception');
      // 重新抛出异常，保证原有错误处理逻辑不受影响
      rethrow;
    }
  });
}

调用示例 #

main() {
  final base = MyServiceMethod((List<int> list) => print(list.join('-')));
  WrappingContainer({'base': base}).lookup('base')?.action([1]); // 正常输出: 1
}

方案二：泛型类型安全（保留编译期检查） #

这种方案通过泛型方法让调用方明确指定请求类型，保留编译期类型检查，适合需要严格类型约束的场景，但需要修改调用代码使用泛型版本的lookup方法。

修改后的代码 #

class WrappingContainer extends Service {
  WrappingContainer(super.map);

  // 覆盖原lookup方法，提示使用类型安全的泛型版本
  @override
  ServiceMethod? lookup(String name) {
    throw UnsupportedError('请使用lookupTyped<Q>方法获取类型安全的ServiceMethod');
  }

  ServiceMethod<Q>? lookupTyped<Q>(String name) {
    final original = super.lookup(name);
    if (original == null) return null;
    // 类型转换安全，因为调用方明确知道Q的实际类型
    return Wrapper<Q>(original as ServiceMethod<Q>);
  }
}

class Wrapper<Q> extends MyServiceMethod<Q> {
  final ServiceMethod<Q> _original;

  Wrapper(this._original) : super((Q request) {
    // --- 插入Sentry埋点逻辑 ---
    final startTime = DateTime.now();
    try {
      _original.action(request);
      // 记录成功耗时
      final duration = DateTime.now().difference(startTime);
      print('方法调用成功，耗时${duration.inMilliseconds}ms');
    } catch (exception, stackTrace) {
      // 上报异常到Sentry
      // Sentry.captureException(exception, stackTrace: stackTrace);
      print('调用失败，上报异常: $exception');
      rethrow;
    }
  });
}

调用示例 #

main() {
  final base = MyServiceMethod((List<int> list) => print(list.join('-')));
  WrappingContainer({'base': base}).lookupTyped<List<int>>('base')?.action([1]); // 正常输出: 1
}

关键注意事项 #

1. 埋点逻辑中必须rethrow异常，避免吞掉错误导致gRPC服务无法正确返回错误响应。
2. 方案一的动态调用不会影响原有逻辑的执行，只要调用方传入的参数类型与原处理器匹配，就能正常运行。
3. 方案二的泛型方式可以在编译期检查参数类型，避免传入错误类型的请求。

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