跨平台开发 / 系统课时

发送 POST 请求提交数据

发送 POST 请求提交数据

本篇将完成 Flutter 应用向服务器提交数据的流程,学习如何设置请求头、构造 JSON 请求体,并根据接口响应判断提交结果。

学习目标

  • 理解 POST 请求与 GET 请求的数据传递区别
  • 使用 Flutter 发送带 JSON 请求体的 POST 请求
  • 掌握请求头、响应状态和异常处理方法

构造 POST 请求数据

POST 请求主要用于向服务器提交数据,例如创建用户、提交订单或发送表单。与 GET 将参数放在 URL 中不同,POST 通常把数据放在请求体中。

Flutter 使用 http.post 方法发送 POST 请求,可以通过 headers 指定内容类型,通过 body 传递 JSON 字符串。

dart
import 'dart:convert';

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

Future<void> createUser() async {
  final uri = Uri.parse('https://api.example.com/users');

  final response = await http.post(
    uri,
    headers: {
      'Content-Type': 'application/json',
    },
    body: jsonEncode({
      'name': 'Alice',
      'age': 20,
    }),
  );

  if (response.statusCode == 201) {
    print('创建成功');
  } else {
    print('创建失败: ${response.statusCode}');
  }
}

预期输出

text
创建成功

示例中的接口地址仅表示请求目标位置,实际项目中需要替换为后端提供的真实 API 地址。

设置请求头和请求体

服务器需要根据请求头判断如何解析数据。提交 JSON 时通常需要设置:

配置 作用
Content-Type 告诉服务器请求体格式
Authorization 携带身份认证信息
Accept 声明期望返回的数据格式

请求体中的 Dart Map 不能直接作为 HTTP 内容发送,需要使用 jsonEncode 转换为 JSON 字符串。

根据响应判断提交结果

POST 请求完成后,应根据 HTTP 状态码判断操作结果。

常见状态码包括:

状态码 含义
201 资源创建成功
400 请求参数错误
401 身份认证失败
500 服务端异常

业务代码中不要只判断成功或失败,还需要根据不同错误类型给用户提供对应反馈。

处理提交失败情况

网络提交可能因为断网、超时或服务器异常失败。实际应用通常需要捕获异常,并避免因为请求失败导致页面状态异常。

dart
Future<void> submitData() async {
  try {
    final response = await http.post(
      Uri.parse('https://api.example.com/form'),
      body: {'value': 'test'},
    );

    print(response.statusCode);
  } catch (error) {
    print('网络请求异常: $error');
  }
}

预期输出

text
请求成功时打印 HTTP 状态码,例如 200
请求异常时打印网络错误信息

POST 请求的安全注意事项

POST 可以提交更多数据,但并不代表数据天然安全。敏感信息仍需要通过 HTTPS 传输,并结合身份认证、权限校验和服务端验证。

客户端负责组织请求和展示结果,真正的数据校验必须由服务器完成。

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

目录与阅读设置

阅读设置

17

记录一个想法

发送 POST 请求提交数据

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

登录哪都通