如何在 Flutter 中处理网络和 API？

Question

Accepted Answer

Flutter 应用经常需要与 **API** 进行通信 — 发送 HTTP 请求、解析 JSON 和处理响应/错误。使用 **http** 或 **dio** 包、**async/await** 和 JSON 解析，网络通信是大多数应用的核心部分。 ## 发送 HTTP 请求 ```dart import 'package:http/http.dart' as http; // GET request Future> fetchUsers() async { final response = await http.get(Uri.parse('https://api.example.com/users')); if (response.statusCode == 200) { final List data = jsonDecode(response.body); // parse JSON return data.map((json) => User.fromJson(json)).toList(); } else { throw Exception('Failed to load users'); // handle errors } } // POST request await http.post( Uri.parse('https://api.example.com/users'), headers: {'Content-Type': 'application/json'}, body: jsonEncode({'name': 'Ann'}), ); ``` ## JSON 解析（序列化） ```dart // model class with fromJson/toJson (convert between JSON and Dart objects) class User { final String name; User(this.name); factory User.fromJson(Map json) => User(json['name']); Map toJson() => {'name': name}; } // → for many models, use code generation (json_serializable) to avoid boilerplate ``` ## 最佳实践 ```text ✓ Use a SERVICE/repository layer (separate networking from UI) — clean architecture ✓ Handle ERRORS (network failures, non-200 status, timeouts) gracefully → show UI feedback ✓ Show LOADING states (FutureBuilder / state management) ✓ Use DIO for advanced needs (interceptors, retries, better config) vs basic http ✓ Parse JSON into typed MODELS (not raw maps) — type safety ✓ Handle auth (tokens in headers), timeouts, and cancellation ``` ## 为什么这很重要理解 Flutter 中的网络和 API 是必要的，因为 **大多数应用都需要与后端通信** — 通过 HTTP 获取和发送数据是几乎每个真实应用的核心部分，因此这是必须了解的实践知识。应用经常需要发起 API 调用（加载数据、提交表单、身份验证），理解如何正确地做这件事是基础。了解如何 **发送 HTTP 请求**（使用 `http` 或 `dio` 包进行 GET、POST 等操作，配合 async/await）、**解析 JSON**（将 API 响应转换为类型化的 Dart 模型对象，通过 `fromJson`/`toJson`，最好使用代码生成来处理多个模型）和 **处理响应和错误**（检查状态码、抛出/处理异常）是核心实践技能。理解 **最佳实践** 特别有价值：使用 **service/repository 层** 将网络请求与 UI 分离（清晰架构、可维护性）、**优雅地处理错误**（网络故障、非 200 状态、超时 — 显示适当的 UI 反馈，因为网络调用常常失败）、**显示加载状态**（通过 FutureBuilder 或状态管理，获得良好的 UX）、将 JSON 解析为 **类型化模型**（为了类型安全而不是原始 map）以及处理身份验证和超时 — 这些反映了构建健壮、可维护的网络代码，而不是脆弱的临时拼凑。由于大多数 Flutter 应用都需要与 API 通信（几乎是通用需求），并且做好它（适当的请求、将 JSON 解析为模型、错误处理、加载状态和清晰架构）对于功能性、健壮的应用至关重要，并且理解相关工具和最佳实践对于这一核心能力是必要的，因此理解 Flutter 中的网络和 API 是必要的、经常应用的实践知识 — 在几乎每个与后端通信的真实 Flutter 应用中都需要的基础技能，是构建能够可靠地获取和显示真实数据的应用的核心。