跨平台开发 / 系统课时
取消无效请求并避免重复加载
取消无效请求并避免重复加载
页面离开后请求仍在返回、快速切换时旧响应覆盖新结果、按钮连续点击造成重复请求,都是 Flutter 异步页面常见问题。本节用“取消旧请求 + 阻止同一请求重复触发 + mounted/请求代次校验”建立一套可直接复用的防护方式。
学习目标
- 在页面销毁或查询条件变化时主动取消已失效的网络请求
- 阻止相同操作被连续触发,避免重复加载和重复状态更新
- 使用
mounted与请求代次校验,防止过期响应更新当前页面
三类无效请求从哪里产生
页面中的请求并不会因为 Widget 不再可见就自动停止。常见问题有三类:用户离开页面后请求才完成;筛选条件快速变化时,较早发出的请求较晚返回;同一按钮被连续点击,短时间创建多个等价请求。

只做 mounted 检查只能阻止页面销毁后的 setState,却不能节省已经失效的网络传输,也不能解决“旧请求晚返回覆盖新请求”。因此更稳妥的策略是:能取消时主动取消,同时再用状态校验兜底。
用 CancelToken 管理请求生命周期
示例使用 dio 的 CancelToken。先添加依赖:
flutter pub add dio预期输出:
Resolving dependencies...
Got dependencies!实际解析到的版本号和附带依赖可能不同。下面是完整可运行的 main.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(),
],
],
),
),
);
}
}预期结果:
点击“加载用户 1”后显示“用户 1:Leanne Graham”。
在请求未完成前重复点击同一按钮,不会创建第二个同类请求。
快速点击“加载用户 1”再点击“加载用户 2”时,旧请求被取消,只允许用户 2 的最新结果更新页面。
离开页面时,活动请求被取消,不会发生 dispose 之后调用 setState 的错误。网络不可用或测试服务异常时,页面会进入“加载失败”分支,具体错误类型可能不同。
为什么还要做请求代次校验
取消请求并不等于“绝对不会再收到旧结果”。某些请求可能在取消信号发出前已经完成,或底层客户端无法真正终止某个阶段。示例中的 _requestGeneration 为每次有效请求分配递增代次,只有当前代次可以更新状态。
这层校验还解决了快速切换时的竞态:无论 Request A 与 Request B 以什么顺序返回,只要 B 是最新请求,A 的响应就会被忽略。mounted 则负责确认 State 仍属于组件树,两者解决的是不同问题。
重复加载应该在什么位置拦截
最简单的重复点击防护是加载期间禁用按钮,但当页面允许切换不同参数时,完全禁用会妨碍用户发起新查询。示例因此只拦截“同一 userId 且仍在加载”的情况;参数不同则取消旧请求并启动新请求。
如果操作具有副作用,例如创建订单、提交支付或写入数据库,仅靠前端防重复还不够。客户端应避免重复触发,服务端同时需要幂等键或业务去重,不能把一致性责任只放在 Flutter 页面。
当请求不再有价值时主动取消、当响应不再属于当前状态时拒绝更新,这两层规则一起使用,才能在页面销毁、快速切换和连续点击下保持异步状态稳定。