Flutter API请求次数随Widget切换递增问题排查求助

1. 状态监听/订阅未及时取消 #

如果用了Stream、ChangeNotifier这类状态管理工具，每次进入Widget就新增监听，但离开时没移除旧监听，会导致旧监听残留，下次进入叠加新监听，触发请求次数翻倍。

• 错误示例：

@override
void initState() {
  super.initState();
  // 每次进入都加新监听，旧的没销毁
  someViewModel.dataStream.listen((_) => fetchData());
}

• 修复：在dispose里取消订阅

StreamSubscription? _sub;

@override
void initState() {
  super.initState();
  _sub = someViewModel.dataStream.listen((_) => fetchData());
}

@override
void dispose() {
  _sub?.cancel(); // 必须销毁订阅
  super.dispose();
}

2. initState被重复调用 #

initState理论上只执行一次，但如果父Widget重建时没有给当前Widget设置唯一Key，或者用了StatelessWidget却频繁因父级状态变化重建，会导致initState多次触发，重复发起请求。

• 解决：给Widget设置唯一Key，比如MyWidget(key: UniqueKey())；如果是无状态Widget，尽量用const构造函数避免不必要重建。

3. FutureBuilder使用错误 #

如果直接在FutureBuilder的future参数里创建请求，每次Widget重建都会重新发起请求：

• 错误示例：

FutureBuilder(
  future: fetchData(), // 每次build都调用，触发多次请求
  builder: (ctx, snapshot) { ... },
)

• 修复：在initState里初始化请求并保存为成员变量

late Future<Data> _dataFuture;

@override
void initState() {
  super.initState();
  _dataFuture = fetchData(); // 只初始化一次
}

@override
Widget build(BuildContext context) {
  return FutureBuilder(
    future: _dataFuture,
    builder: (ctx, snapshot) { ... },
  );
}

4. 全局状态管理的订阅残留 #

用Provider、Bloc这类全局状态工具时，每次进入Widget都注册新监听，离开时没注销，会导致多个监听同时存在，触发时多次执行请求逻辑。

• 修复：使用支持自动销毁的监听方式（比如Bloc的autoDispose扩展），或者在dispose中手动移除监听。

5. AutomaticKeepAliveClientMixin使用不当 #

如果用这个mixin保持Widget状态，但没实现wantKeepAlive或没调用super.build(context)，会导致状态异常，间接触发多次请求。

• 正确用法：

class _MyWidgetState extends State<MyWidget> with AutomaticKeepAliveClientMixin {
  @override
  bool get wantKeepAlive => true;

  @override
  void initState() {
    super.initState();
    fetchData();
  }

  @override
  Widget build(BuildContext context) {
    super.build(context); // 必须调用
    return ...;
  }
}

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