跨平台开发 / 系统课时

用 Dio 发送 POST 请求

用 Dio 发送 POST 请求

本篇将解决 Flutter 应用如何向服务端提交数据的问题,重点掌握 Dio 发送 JSON 和表单请求的方式,以及请求体格式与 Content-Type 之间的关系。

学习目标

  • 理解 POST 请求中请求体、Content-Type 与服务端解析方式的关系
  • 使用 Dio 构造 JSON 和表单数据请求
  • 掌握提交数据时常见的参数组织方式和排查方法

POST 请求中的数据提交方式

POST 请求通常用于向服务端提交数据,例如用户登录、创建订单、上传配置等场景。与 GET 请求主要通过 URL 携带参数不同,POST 更关注请求体中的数据结构。

在 Flutter 中使用 Dio 发送 POST 请求时,最关键的是明确服务端期望的数据格式。常见格式包括 JSON 和表单数据:

数据格式 Content-Type 常见场景
JSON application/json REST API、业务接口
表单 application/x-www-form-urlencoded 传统接口、简单提交

如果 Content-Type 与实际发送的数据格式不匹配,服务端可能无法正确解析请求内容。

使用 Dio 提交 JSON 数据

Dio 会根据传入的数据类型帮助构造请求,但实际项目中通常会明确指定请求头,保证客户端与服务端约定一致。

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

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

  final response = await dio.post(
    'https://api.example.com/users',
    data: {
      'name': 'Alice',
      'age': 20,
    },
    options: Options(
      headers: {
        'Content-Type': 'application/json',
      },
    ),
  );

  print(response.data);
}

预期输出

text
{message: user created, id: 1001}

这里的 data 会作为请求体发送。Dio 会将 Dart Map 转换为 JSON 格式,最终传递给服务端。

提交表单数据

部分接口要求使用表单格式提交,例如旧系统登录接口或简单数据收集接口。此时可以使用 FormData。

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

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

  final formData = FormData.fromMap({
    'username': 'alice',
    'password': 'secret',
  });

  final response = await dio.post(
    'https://api.example.com/login',
    data: formData,
  );

  print(response.statusCode);
}

预期输出

text
200

FormData 适合提交键值结构数据,也支持文件上传等 multipart 场景。

请求失败时如何检查

当 POST 请求返回错误时,不要只检查状态码,还需要确认请求体是否符合接口要求。

常见检查顺序如下:

  • 查看接口文档确认 Content-Type 要求
  • 检查发送字段名称是否与服务端一致
  • 使用网络调试工具确认实际请求体内容
  • 检查服务端返回的错误信息

例如,服务端要求 JSON,而客户端发送了普通字符串,即使 URL 正确,请求也可能失败。

实际开发中,优先根据接口协议选择数据格式,而不是根据客户端习惯决定发送方式。JSON 更适合现代业务 API,FormData 则更适合表单和文件上传场景。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 Dio 发送 POST 请求

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

登录哪都通