跨平台开发 / 系统课时

发送 HTTP GET 请求

发送 HTTP GET 请求

本篇将实现 Flutter 应用向服务器获取数据的完整流程,使用 HTTP 客户端发送 GET 请求,解析响应内容,并掌握异步请求中的常见处理方式。

学习目标

  • 理解 Flutter 中发送 HTTP GET 请求的基本流程
  • 使用 HTTP 客户端完成网络请求并解析 JSON 响应
  • 掌握异步请求中的加载、成功和失败处理方式

使用 http 客户端发起 GET 请求

Flutter 本身不直接提供业务层 HTTP 请求封装,实际开发中通常使用 http 等客户端库完成网络通信。一个 GET 请求通常包含创建请求、等待响应、检查状态码和解析数据几个步骤。

在项目中添加依赖后,可以通过 http.get 方法发送请求。下面示例请求一个返回 JSON 数据的接口,并将响应解析为 Dart 对象。

dart
import 'dart:convert';

import 'package:flutter/material.dart';
import 'package:http/http.dart' as http;

void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  Future<void> loadUser() async {
    final uri = Uri.parse('https://api.example.com/users/<ID>');
    final response = await http.get(uri);

    if (response.statusCode == 200) {
      final data = jsonDecode(response.body);
      print(data['name']);
    } else {
      throw Exception('请求失败: ${response.statusCode}');
    }
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        body: Center(
          child: ElevatedButton(
            onPressed: loadUser,
            child: const Text('加载用户'),
          ),
        ),
      ),
    );
  }
}

预期输出

text
控制台打印接口返回 JSON 中的 name 字段值

示例中的 <ID> 表示实际资源编号,真实项目中应替换为接口要求的用户标识。

理解 Future 与异步响应

网络请求具有不可预测的耗时,不能阻塞 Flutter 主线程。因此 HTTP 方法返回 Future<Response>,调用方需要使用 await 等待结果。

常见页面状态通常包含三种情况:

状态 处理方式
请求中 显示加载组件
请求成功 更新页面数据
请求失败 展示错误信息

实际开发中通常不会直接在按钮事件里处理全部逻辑,而是放入状态管理层或独立的数据服务类中。

处理响应数据和异常

HTTP 响应主要关注两个部分:状态码和响应体。

200 通常表示请求成功,响应体中的 JSON 可以通过 jsonDecode 转换为 Dart 对象。对于网络异常、服务端错误或数据格式异常,需要提前设计错误处理逻辑。

GET 请求的使用边界

GET 适合读取资源,例如获取用户信息、商品列表、文章内容等。它的请求参数通常放在 URL 查询参数中,不适合提交大量敏感数据。

当接口需要提交数据、修改资源状态或携带复杂请求体时,应考虑使用 POST 或其他 HTTP 方法。

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

目录与阅读设置

阅读设置

17

记录一个想法

发送 HTTP GET 请求

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

登录哪都通