项目场景：
-
在开发Spring Boot项目时，我们经常需要通过RESTful API接收来自客户端的JSON格式请求参数。然而，在某些情况下，您可能会遇到一个问题：当客户端发送的JSON字段名以大写字母开头时，Spring Boot默认的Jackson序列化/反序列化机制无法正确映射这些字段到Java对象中，导致接收不到参数。
-
本文将介绍如何通过添加一个注解来解决这个问题，并确保Spring Boot能够正确解析首字母大写的JSON字段。
问题描述
- 假设我们有一个简单的Java类 User，用于接收来自客户端的JSON请求：
public class User {
private String name;
private int age;
// Getters and Setters
}
- 对应的Controller方法如下：
@RestController
@RequestMapping("/api")
public class UserController {
@PostMapping("/user")
public ResponseEntity<String> createUser(@RequestBody User user) {
return ResponseEntity.ok("Received user: " + user.getName() + ", " + user.getAge());
}
}
- 如果客户端发送的JSON请求如下：
json">{
"Name": "Alice",
"Age": 25
}
原因分析：
- 由于JSON字段名
Name和Age首字母大写，而Java类中的字段名name和age是小写的，Spring Boot 默认使用 Jackson 进行反序列化时，会忽略这些字段，导致 user.getName() 和 user.getAge() 返回 null 或默认值。
解决方案一 使用 @JsonAlias 注解：
@JsonAlias是Jackson提供的一个注解，允许为Java字段指定多个别名。这样，即使JSON字段名与Java字段名不完全匹配，Jackson也能正确映射它们。
步骤：
1、修改 User 类：为每个字段添加 @JsonAlias 注解，指定可能的JSON字段名。
import com.fasterxml.jackson.annotation.JsonAlias;
public class User {
@JsonAlias({"name", "Name"})
private String name;
@JsonAlias({"age", "Age"})
private int age;
// Getters and Setters
}
2、测试：现在，无论客户端发送的JSON字段名是 name、Name、age 还是 Age，Spring Boot 都能正确解析并映射到 User 对象中。
方案二：使用 @JsonProperty 注解
-
除了
@JsonAlias，您还可以使用@JsonProperty注解来显式指定JSON字段名。这对于特定字段的映射非常有用。 -
示例：
import com.fasterxml.jackson.annotation.JsonProperty;
public class User {
@JsonProperty("Name")
private String name;
@JsonProperty("Age")
private int age;
// Getters and Setters
}
- 这种方式适用于单个字段的映射，但如果需要处理多个字段或多种命名方式，
@JsonAlias可能更为灵活。
