使用显式容器让测试保持稳定。
大多数测试场景都能直接映射到 ProviderContainer 的接口：read、invalidate、refresh、listen，以及按实例覆盖。
Test Strategy
将测试拆分为纯容器测试和 widget 集成测试。
Pure Dart
直接使用 ProviderContainer 做 read / invalidate / refresh 断言
Overrides
通过 overrideWith / overrideWithValue 按提供者实例覆盖
Widget tests
注入外部容器，并显式释放
Tip
除非指定 fireImmediately: true，否则 ProviderContainer.listen 不会发出初始值。
测试命令与检查清单
运行完整测试集，并确认 autoDispose 场景中没有悬挂计时器泄漏。
Command
Checklist
- Dispose externally injected ProviderContainer in tearDown.
- Use fireImmediately: true when your listener assertions need initial state.
- For autoDispose tests, advance fake time beyond autoDisposeDelay.
示例：按参数覆盖
类似 family 的提供者会根据工厂函数创建出的每个实例分别覆盖。
class ProductById extends Provider<Product> {
ProductById(this.id) : super.args((id,));
final String id;
@override
Product build(ref) {
final repo = ref.watch(productRepoProvider);
return repo.fetch(id);
}
}
final container = ProviderContainer(
overrides: [
productByIdProvider('a').overrideWithValue(const Product(id: 'a', name: 'stub')),
],
);
// assert and cleanup
container.dispose();
这个模式与 README 以及 miniriverpod 仓库中的上游测试保持一致。
Widget 测试在释放外部容器前，应该先卸载 widget。
使用 fake_async 验证 autoDispose 延迟与 keepAlive 行为。