为何Dart StreamController的stream getter每次返回不同流？

我在业余项目中使用Dart时发现一个奇怪的行为：dart:async库中的StreamController类，每次调用其stream getter都会返回不同的Stream实例。这一点在官方文档中并未明确说明，文档仅表明StreamController拥有其控制的Stream。

我编写了以下测试代码：

import 'dart:async';

void main() {
  final streamController = StreamController<int>();
  print('streams identical: ${identical(streamController.stream, streamController.stream)}');
}

预期输出是streams identical: true，但实际得到streams identical: false。作为一门按引用传递的语言，这种行为看起来有些反常，我原本想基于观察者模式实现逻辑，但受限于FirebaseAuth的API（我正在为它编写测试Mock，该API通过Stream实现Auth状态变更监听）。我已经找到了解决办法，但想搞清楚这个设计的原因，以及为什么文档没有提及这一细节。

问题解答 #

1. 设计核心：隔离控制权与监听权限 #

StreamController的stream getter返回的是包装后的Stream实例（内部实现通常是_StreamWrapper或类似封装类），而非控制器持有的原始Stream。每次调用返回新的包装对象，是为了严格隔离流的控制权和监听权限：

• 控制器持有者可以调用add、close等方法修改流的状态；
• 外部调用者通过stream拿到的实例只能进行订阅操作，无法直接操作控制器，即使尝试类型转换也无法突破封装，保证了流的安全性和稳定性。

2. 实例同一性并非设计要求 #

Dart的Stream设计核心是事件传递的正确性，而非返回实例的同一性。文档没有明确提及这一细节，是因为对绝大多数开发者来说，只要能正常监听事件，实例是否相同并不影响业务逻辑——开发者不需要依赖identical判断来使用Stream。

3. 预留扩展空间 #

这种设计也给框架留了灵活的扩展空间：如果后续需要，StreamController可以在每次返回Stream时添加不同的转换逻辑（比如过滤、映射），而不需要修改现有API。对普通开发者来说，这种灵活性是透明的，不会影响日常使用。

针对Mock场景的实现建议 #

如果你需要在FirebaseAuth的Mock中保证authStateChanges()这类方法返回同一Stream实例，只需要在Mock类中缓存StreamController.stream的返回值即可，示例如下：

class MockFirebaseAuth extends FirebaseAuth {
  final _controller = StreamController<User?>();
  Stream<User?>? _authStream;

  @override
  Stream<User?> authStateChanges() {
    _authStream ??= _controller.stream;
    return _authStream!;
  }

  // 其他Mock方法...
}

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