跨平台开发 / 系统课时

取消无效请求并避免重复加载

取消无效请求并避免重复加载

页面离开后请求仍在返回、快速切换时旧响应覆盖新结果、按钮连续点击造成重复请求,都是 Flutter 异步页面常见问题。本节用“取消旧请求 + 阻止同一请求重复触发 + mounted/请求代次校验”建立一套可直接复用的防护方式。

学习目标

  • 在页面销毁或查询条件变化时主动取消已失效的网络请求
  • 阻止相同操作被连续触发,避免重复加载和重复状态更新
  • 使用 mounted 与请求代次校验,防止过期响应更新当前页面

三类无效请求从哪里产生

页面中的请求并不会因为 Widget 不再可见就自动停止。常见问题有三类:用户离开页面后请求才完成;筛选条件快速变化时,较早发出的请求较晚返回;同一按钮被连续点击,短时间创建多个等价请求。

页面异步请求失效与取消流程

只做 mounted 检查只能阻止页面销毁后的 setState,却不能节省已经失效的网络传输,也不能解决“旧请求晚返回覆盖新请求”。因此更稳妥的策略是:能取消时主动取消,同时再用状态校验兜底。

用 CancelToken 管理请求生命周期

示例使用 dio 的 CancelToken。先添加依赖:

bash
flutter pub add dio

预期输出:

text
Resolving dependencies...
Got dependencies!

实际解析到的版本号和附带依赖可能不同。下面是完整可运行的 main.dart。同一个用户正在加载时再次点击会被忽略;切换到另一个用户时会取消旧请求;页面销毁时也会取消当前请求。

dart
import 'package:dio/dio.dart';
import 'package:flutter/material.dart';

void main() {
  runApp(const MaterialApp(home: UserPage()));
}

class UserPage extends StatefulWidget {
  const UserPage({super.key});

  @override
  State<UserPage> createState() => _UserPageState();
}

class _UserPageState extends State<UserPage> {
  final Dio _dio = Dio(
    BaseOptions(baseUrl: 'https://jsonplaceholder.typicode.com'),
  );

  CancelToken? _cancelToken;
  int _requestGeneration = 0;
  int? _loadingUserId;
  bool _loading = false;
  String _message = '请选择用户';

  Future<void> _loadUser(int userId) async {
    // 同一用户正在加载时忽略重复点击,避免创建等价请求。
    if (_loading && _loadingUserId == userId) return;

    _cancelToken?.cancel('Replaced by a newer request');
    final token = CancelToken();
    _cancelToken = token;
    final generation = ++_requestGeneration;

    setState(() {
      _loading = true;
      _loadingUserId = userId;
      _message = '正在加载用户 $userId...';
    });

    try {
      final response = await _dio.get<Map<String, dynamic>>(
        '/users/$userId',
        cancelToken: token,
      );

      // 即使取消信号与响应同时到达,也只允许最新请求更新页面。
      if (!mounted || generation != _requestGeneration) return;

      final name = response.data?['name'] as String? ?? '未知用户';
      setState(() {
        _message = '用户 $userId:$name';
      });
    } on DioException catch (e) {
      if (CancelToken.isCancel(e)) return;
      if (!mounted || generation != _requestGeneration) return;

      setState(() {
        _message = '加载失败:${e.type.name}';
      });
    } finally {
      if (mounted && generation == _requestGeneration) {
        setState(() {
          _loading = false;
          _loadingUserId = null;
        });
      }
    }
  }

  @override
  void dispose() {
    _requestGeneration++;
    _cancelToken?.cancel('Page disposed');
    _dio.close(force: true);
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('请求取消示例')),
      body: Padding(
        padding: const EdgeInsets.all(24),
        child: Column(
          crossAxisAlignment: CrossAxisAlignment.start,
          children: [
            Text(_message),
            const SizedBox(height: 16),
            Wrap(
              spacing: 12,
              children: [
                FilledButton(
                  onPressed: () => _loadUser(1),
                  child: const Text('加载用户 1'),
                ),
                FilledButton(
                  onPressed: () => _loadUser(2),
                  child: const Text('加载用户 2'),
                ),
              ],
            ),
            if (_loading) ...[
              const SizedBox(height: 16),
              const CircularProgressIndicator(),
            ],
          ],
        ),
      ),
    );
  }
}

预期结果:

text
点击“加载用户 1”后显示“用户 1:Leanne Graham”。
在请求未完成前重复点击同一按钮,不会创建第二个同类请求。
快速点击“加载用户 1”再点击“加载用户 2”时,旧请求被取消,只允许用户 2 的最新结果更新页面。
离开页面时,活动请求被取消,不会发生 dispose 之后调用 setState 的错误。

网络不可用或测试服务异常时,页面会进入“加载失败”分支,具体错误类型可能不同。

为什么还要做请求代次校验

取消请求并不等于“绝对不会再收到旧结果”。某些请求可能在取消信号发出前已经完成,或底层客户端无法真正终止某个阶段。示例中的 _requestGeneration 为每次有效请求分配递增代次,只有当前代次可以更新状态。

这层校验还解决了快速切换时的竞态:无论 Request A 与 Request B 以什么顺序返回,只要 B 是最新请求,A 的响应就会被忽略。mounted 则负责确认 State 仍属于组件树,两者解决的是不同问题。

重复加载应该在什么位置拦截

最简单的重复点击防护是加载期间禁用按钮,但当页面允许切换不同参数时,完全禁用会妨碍用户发起新查询。示例因此只拦截“同一 userId 且仍在加载”的情况;参数不同则取消旧请求并启动新请求。

如果操作具有副作用,例如创建订单、提交支付或写入数据库,仅靠前端防重复还不够。客户端应避免重复触发,服务端同时需要幂等键或业务去重,不能把一致性责任只放在 Flutter 页面。

当请求不再有价值时主动取消、当响应不再属于当前状态时拒绝更新,这两层规则一起使用,才能在页面销毁、快速切换和连续点击下保持异步状态稳定。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

取消无效请求并避免重复加载

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通