跨平台开发 / 系统课时
用 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
200FormData 适合提交键值结构数据,也支持文件上传等 multipart 场景。
请求失败时如何检查
当 POST 请求返回错误时,不要只检查状态码,还需要确认请求体是否符合接口要求。
常见检查顺序如下:
- 查看接口文档确认 Content-Type 要求
- 检查发送字段名称是否与服务端一致
- 使用网络调试工具确认实际请求体内容
- 检查服务端返回的错误信息
例如,服务端要求 JSON,而客户端发送了普通字符串,即使 URL 正确,请求也可能失败。
实际开发中,优先根据接口协议选择数据格式,而不是根据客户端习惯决定发送方式。JSON 更适合现代业务 API,FormData 则更适合表单和文件上传场景。
按自己的节奏,确认真正理解。