Java 对象序列化

方向	名称	过程	举例
Java → JSON	序列化	把 Java 对象转成 JSON 字符串	返回 API 响应给前端
JSON → Java	反序列化	把 JSON 字符串转成 Java 对象	接收前端传来的请求体

大白话

Java 对象 → JSON（序列化）

在 Spring Boot 中，当你在 Controller 方法中返回一个 Java 对象（而不是 String、ResponseEntity 等原始类型），并且该方法被 @RestController 或 @ResponseBody 标注时，Spring 会自动将这个 Java 对象通过 Jackson（或其他配置的 JSON 库）序列化为 JSON 字符串，并作为 HTTP 响应体返回给客户端。

java 复制代码

@RestController
public class UserController {

    @GetMapping("/user")
    public User getUser() {
        User user = new User();
        user.setId("123");
        user.setName("Alice");
        user.setCreateTime(LocalDateTime.now());
        return user; // ← 返回的是 Java 对象
    }
}

Spring MVC 拦截到 getUser() 的返回值：User 对象。
因为有 @RestController，Spring 知道要把它转成 JSON。
使用 Jackson（默认）调用 ObjectMapper.writeValueAsString(user)。
将生成的 JSON 字符串写入 HTTP 响应体。
客户端收到：

java 复制代码

{
  "id": "123",
  "name": "Alice",
  "createTime": "2026-05-30T15:00:00"
}

JSON → Java（反序列化）

而 JSON → Java（反序列化）发生在你接收前端传来的 JSON 数据时，比如：

java 复制代码

@PostMapping("/user")
public Result createUser(@RequestBody User user) { // ← 这里是反序列化！
    // user 是从 JSON 自动转换来的 Java 对象
    return Result.success("创建成功", user);
}

java 复制代码

{ "name": "Bob", "id": "999" }

Spring 用 Jackson 把它反序列化成 User 对象。

如果 User.id 字段标了 @JsonProperty(access = READ_ONLY)，那么即使 JSON 里有 "id": "999"，user.getId() 也会是 null！

场景	方向	是否用到 `@JsonProperty(access = READ_ONLY)`
Controller 返回对象	Java → JSON（序列化）	✅ `READ_ONLY` 字段会出现在响应中
Controller 接收 `@RequestBody`	JSON → Java（反序列化）	✅ `READ_ONLY` 字段会被忽略，不赋值

操作	用途	Jackson 默认行为
序列化（Java → JSON）	把 Java 对象转成 JSON 字符串	调用 getter 方法（如 `getStatusName()`）或直接读取字段
反序列化（JSON → Java）	把 JSON 字符串转成 Java 对象	调用 setter 方法（如 `setStatus(String)`）或直接写入字段

主流 JSON 库（如 Jackson）在序列化时默认通过 getter 或字段读取值，在反序列化时默认通过 setter 或字段写入值，具体行为受可见性、注解和配置影响。