rest怎么接收json

RESTful API 中如何接收 JSON 数据：从基础到实践

在现代 Web 开发中，RESTful API 已成为前后端数据交互的主流方式，而 JSON（JavaScript Object Notation）凭借其轻量级、易读、易于解析的特性，成为 API 请求与响应中最常用的数据格式，本文将详细讲解在 RESTful API 中，后端如何正确接收前端发送的 JSON 数据，涵盖请求方式、请求体格式、后端解析逻辑及常见问题处理。

RESTful API 接收 JSON 的核心基础：请求方式与数据位置

RESTful API 的核心是基于 HTTP 协议的接口设计，接收 JSON 数据主要涉及 POST、PUT、PATCH 三种请求方式（这些方式通常用于“创建”或“更新”资源，需要客户端向服务端提交数据），而 JSON 数据主要存储在 HTTP 请求的 请求体（Request Body） 中。

请求方式的选择

• POST：用于创建新资源，请求体中包含要创建的资源数据（如用户注册时提交的用户信息）。
• PUT：用于完全更新资源，请求体中包含完整的资源数据（如修改用户的所有信息）。
• PATCH：用于部分更新资源，请求体中包含需要修改的字段（如仅修改用户的手机号）。

这三种方式均支持通过请求体传递 JSON 数据，而 GET 请求（用于查询资源）通常不通过请求体传参（数据以查询字符串形式存在于 URL 中）。

HTTP 请求体的结构

当客户端发送 JSON 数据时，HTTP 请求头（Headers）中会包含 Content-Type: application/json 字段，告知服务端请求体的数据格式是 JSON；服务端则需通过解析请求体，提取其中的 JSON 数据并处理。

后端如何接收 JSON 数据：分语言/框架实践

不同后端语言和框架接收 JSON 数据的方式略有差异，但核心逻辑一致：解析请求体中的 JSON 字符串，转换为编程语言中的对象/字典，以下以主流技术栈为例，说明具体实现。

Node.js（Express 框架）

Express 是 Node.js 中最常用的 Web 框架，通过 express.json() 中间件即可轻松解析 JSON 请求体。

示例代码：

const express = require('express');
const app = express();
// 使用内置中间件解析 JSON 请求体（必须放在路由之前）
app.use(express.json());
// 定义 POST 路由，接收 JSON 数据
app.post('/api/users', (req, res) => {
    // req.body 即为解析后的 JSON 对象
    const { name, age, email } = req.body;
    console.log('接收到的 JSON 数据:', req.body);
    // 模拟数据处理
    const newUser = { id: Date.now(), name, age, email };
    res.status(201).json({
        code: 201,
        message: '用户创建成功',
        data: newUser
    });
});
app.listen(3000, () => {
    console.log('服务器运行在 http://localhost:3000');
});

关键点：

• app.use(express.json())：启用 Express 内置的 JSON 中间件，自动解析 Content-Type: application/json 的请求体，并将结果挂载到 req.body 上。
• 未使用中间件时,req.body 为 undefined，无法直接获取 JSON 数据。

Python（Flask 框架）

Flask 是 Python 中轻量级的 Web 框架，通过 request.get_json() 方法解析 JSON 请求体。

示例代码：

from flask import Flask, request, jsonify
app = Flask(__name__)
@app.route('/api/users', methods=['POST'])
def create_user():
    # 解析 JSON 请求体，返回字典（若解析失败则返回 400 错误）
    data = request.get_json()
    if not data:
        return jsonify({'code': 400, 'message': '请求体缺少 JSON 数据'}), 400
    # 提取字段
    name = data.get('name')
    age = data.get('age')
    email = data.get('email')
    print(f'接收到的 JSON 数据: {data}')
    # 模拟数据处理
    new_user = {'id': 1, 'name': name, 'age': age, 'email': email}
    return jsonify({
        'code': 201,
        'message': '用户创建成功',
        'data': new_user
    }), 201
if __name__ == '__main__':
    app.run(debug=True)

关键点：

• request.get_json()：解析请求体中的 JSON 数据，返回 Python 字典；若请求体为空或格式错误（如非 JSON 字符串），返回 None（需手动校验）。
• 可通过 request.get_json(force=True) 强制解析（忽略 Content-Type 头），但不推荐（可能导致非 JSON 数据被错误解析）。

Java（Spring Boot 框架）

Spring Boot 是 Java 中企业级应用的主流框架，通过 @RequestBody 注解将 JSON 请求体自动绑定到 Java 对象。

示例代码：

import org.springframework.web.bind.annotation.*;
// 定义一个 DTO（Data Transfer Object）来接收 JSON 数据
class User {
    private String name;
    private Integer age;
    private String email;
    // 必须提供无参构造方法（Spring 依赖注入需要）
    public User() {}
    // getter 和 setter 方法
    public String getName() { return name; }
    public void setName(String name) { this.name = name; }
    public Integer getAge() { return age; }
    public void setAge(Integer age) { this.age = age; }
    public String getEmail() { return email; }
    public void setEmail(String email) { this.email = email; }
    @Override
    public String toString() {
        return "User{" + "name='" + name + '\'' + ", age=" + age + ", email='" + email + '\'' + '}';
    }
}
@RestController
public class UserController {
    // POST 请求，接收 JSON 数据并绑定到 User 对象
    @PostMapping("/api/users")
    public String createUser(@RequestBody User user) {
        // @RequestBody 表示将请求体 JSON 数据转换为 User 对象
        System.out.println("接收到的 JSON 数据: " + user);
        // 模拟数据处理
        user.toString(); // 这里可直接操作 user 对象
        return "用户创建成功: " + user.toString();
    }
}

关键点：

• @RequestBody 注解：标记在方法参数上，Spring Boot 会自动将请求体中的 JSON 数据转换为对应的 Java 对象（需字段名与 JSON 键名一致）。
• 需提供无参构造方法和 getter/setter（或使用 Lombok 简化代码）。

Go（Gin 框架）

Gin 是 Go 语言中高性能的 Web 框架，通过 c.ShouldBindJSON() 方法绑定 JSON 数据到结构体。

示例代码：

package main
import (
    "fmt"
    "net/http"
    "github.com/gin-gonic/gin"
)
// 定义结构体接收 JSON 数据（字段需为大写导出）
type User struct {
    Name  string `json:"name"`
    Age   int    `json:"age"`
    Email string `json:"email"`
}
func main() {
    r := gin.Default()
    // POST 路由，接收 JSON 数据
    r.POST("/api/users", func(c *gin.Context) {
        var user User
        // ShouldBindJSON 绑定 JSON 数据到 user 结构体，失败时返回错误
        if err := c.ShouldBindJSON(&user); err != nil {
            c.JSON(http.StatusBadRequest, gin.H{
                "code": 400,
                "message": fmt.Sprintf("JSON 解析失败: %v", err),
            })
            return
        }
        fmt.Printf("接收到的 JSON 数据: %+v\n", user)
        c.JSON(http.StatusCreated, gin.H{
            "code": 201,
            "message": "用户创建成功",
            "data": user,
        })
    })
    r.Run(":8080") // 监听 8080 端口
}

关键点：

• 结构体标签（如 json:"name"）：指定 JSON 键名与结构体字段的映射关系（若键名与字段名一致，可省略标签）。
• c.ShouldBindJSON()：解析请求体 JSON 并绑定到结构体，若 JSON 格式错误或字段不匹配，返回错误需手动处理。

接收 JSON 数据时的常见问题与解决方案

请求头未包含 Content-Type: application/json

问题：客户端发送 JSON 数据时未设置请求头，或设置错误（如 Content-Type: text/plain），导致后端无法正确识别数据格式。
解决：

• 前端必须设置 Content-Type: application/json（如 JavaScript 的 fetch 或 axios 会自动设置