跨平台开发 / 系统课时

用 Dio 发送 GET 请求

用 Dio 发送 GET 请求

在 Flutter 应用中,Dio 是常用的 HTTP 网络库,它提供了请求封装、响应处理、拦截器和错误管理能力。本篇将创建 Dio 实例并完成一次 GET 请求,读取接口返回的状态码、响应头和数据。

学习目标

  • 掌握 Dio 实例创建和 GET 请求调用方式。
  • 理解 Response 中状态码、请求头和数据字段的作用。
  • 能验证接口调用结果并处理基础异常。

添加 Dio 依赖并创建客户端

Dio 不是 Flutter SDK 自带组件,需要在项目中添加依赖。配置完成后,可以通过 Dio 对象统一管理网络请求。

yaml
# pubspec.yaml 依赖片段示例
# 需要放在 dependencies 节点下

dependencies:
  dio: ^5.7.0

依赖版本可能随项目时间变化,实际开发中应根据项目约束选择兼容版本。

使用 Dio 发起 GET 请求

下面示例请求公开测试接口,并读取响应状态码、响应头和 JSON 数据。

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

Future<void> main() async {
  final dio = Dio();

  try {
    final response = await dio.get(
      'https://jsonplaceholder.typicode.com/todos/1',
    );

    print('status: ${response.statusCode}');
    print('content-type: ${response.headers.value('content-type')}');
    print('data: ${response.data}');
  } on DioException catch (error) {
    print('request failed: ${error.message}');
  }
}

预期输出

text
status: 200
content-type: application/json; charset=utf-8
data: {userId: 1, id: 1, title: delectus aut autem, completed: false}

Dio 会将 JSON 响应自动解析为 Dart 对象结构。response.data 可以直接用于后续模型转换。

理解 Response 中的重要信息

一次 GET 请求完成后,Dio 返回 Response 对象,其中常用字段如下:

字段 用途
statusCode 判断 HTTP 请求是否成功
headers 获取服务器返回的响应头
data 获取解析后的响应内容
requestOptions 查看本次请求配置

业务代码通常不会直接依赖完整响应对象,而是根据状态码和数据内容转换成应用需要的模型。

处理 GET 请求失败

网络请求失败不一定代表服务器错误。Dio 常见异常来源包括连接超时、请求取消、服务器返回错误状态等。

可以根据异常类型记录日志或展示用户提示。例如:

  • 超时:提示用户检查网络后重试。
  • 认证失败:引导用户重新登录。
  • 服务异常:记录错误并等待服务恢复。

生产环境中通常会进一步封装 Dio,例如统一设置基础地址、超时时间和请求拦截器,让页面代码只关注业务数据。

GET 请求的适用边界

GET 适合读取资源,例如获取用户信息、商品列表和配置数据。它通常不会改变服务器状态。

如果操作需要提交业务数据或产生状态变化,应根据接口设计选择其他 HTTP 方法,而不是继续使用 GET 传递复杂参数。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 Dio 发送 GET 请求

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

登录哪都通