spring boot 默认使用 jackson 的 snake_case 命名策略时，会将 java 驼峰字段（如 firstname）自动映射为下划线格式（如 first_name）的 json 键，导致直接发送 {"firstname":"john"} 时字段值为 null。
spring boot 默认使用 jackson 的 snake_case 命名策略时，会将 java 驼峰字段（如 firstname）自动映射为下划线格式（如 first_name）的 json 键，导致直接发送 {"firstname":"john"} 时字段值为 null。
在 Spring Boot 应用中，当您定义了一个标准的 Lombok 数据类（如 SampleRequest），并期望通过 JSON 请求体（@RequestBody）接收驼峰命名（camelCase）字段时，却意外发现所有字段值均为 null，而改用蛇形命名（snake_case，如 "first_name"）反而能正常绑定——这通常不是代码逻辑错误，而是 Jackson 的序列化/反序列化命名策略（Property Naming Strategy）被全局或隐式配置为 SNAKE_CASE 所致。
? 根本原因
Jackson 默认使用 PropertyNamingStrategies.LOWER_CAMEL_CASE（即保持 Java 字段原样），但许多项目（尤其集成 Spring Boot Starter Web 早期版本、或受 spring.jackson.property-naming-strategy=SNAKE_CASE 配置影响）会默认启用蛇形策略。该策略在反序列化时强制将 JSON 键 first_name 映射到 Java 字段 firstName，但不会反向兼容 firstName → firstName；更关键的是：若策略被设为 SNAKE_CASE，Jackson 将忽略原始驼峰键名，仅尝试匹配转换后的下划线形式，从而导致 {"firstName":"John"} 无法绑定。
✅ 正确解决方案
为确保 Java 字段名与 JSON 键名严格一致（即支持 firstName ↔ firstName），需显式指定 Jackson 使用驼峰命名策略。推荐两种方式：
方式一：类级别注解（推荐用于局部控制）
在您的请求 DTO 类上添加 @JsonNaming 注解：
import com.fasterxml.jackson.databind.PropertyNamingStrategies;
import com.fasterxml.jackson.annotation.JsonNaming;
import lombok.Data;
import lombok.AllArgsConstructor;
import lombok.NoArgsConstructor;
import javax.validation.constraints.NotBlank;
@JsonNaming(PropertyNamingStrategies.LowerCamelCaseStrategy.class)
@Data
@AllArgsConstructor
@NoArgsConstructor
public class SampleRequest {
@NotBlank
private String firstName;
private String middleName;
@NotBlank
private String lastName;
}✅ LowerCamelCaseStrategy 是 Jackson 2.12+ 推荐写法（替代已弃用的 LOWER_CAMEL_CASE）。它确保：
- 序列化时：firstName → "firstName"
- 反序列化时："firstName" → firstName
方式二：全局配置（适用于全项目统一风格）
在 application.yml 中设置 Jackson 全局策略：
spring:
jackson:
property-naming-strategy: com.fasterxml.jackson.databind.PropertyNamingStrategies$LowerCamelCaseStrategy或 application.properties：
spring.jackson.property-naming-strategy=com.fasterxml.jackson.databind.PropertyNamingStrategies$LowerCamelCaseStrategy
⚠️ 注意：若项目中已存在 SNAKE_CASE 配置（如 spring.jackson.property-naming-strategy=SNAKE_CASE），必须将其移除或覆盖，否则类级注解可能被全局策略优先级压制（取决于 Jackson 版本和配置加载顺序）。
? 验证示例
使用 Postman 发送标准驼峰 JSON：
{
"firstName": "John",
"middleName": "For",
"lastName": "Doe"
}控制器将正确绑定，sampleRequest.getFirstName() 返回 "John"，不再为 null。
⚠️ 注意事项
- Lombok 的 @Data 不影响 JSON 绑定：它仅生成 getter/setter/toString 等，字段绑定完全由 Jackson 控制。
- 避免混用策略：不要在部分类用 @JsonNaming、其他类依赖全局配置，易引发不一致行为。
- 检查依赖版本：Spring Boot 2.6+ 默认使用 Jackson 2.13+，PropertyNamingStrategies 是首选；旧版请使用 PropertyNamingStrategy.LOWER_CAMEL_CASE（注意包路径差异）。
-
调试技巧：开启 Jackson 日志可定位绑定问题：
logging: level: com.fasterxml.jackson.databind: DEBUG
✅ 总结
API 拒绝驼峰字段的本质是 Jackson 命名策略与预期不匹配。通过显式声明 @JsonNaming(PropertyNamingStrategies.LowerCamelCaseStrategy.class)，即可精准控制反序列化行为，实现 Java 字段名与 JSON 键名的一对一映射。这是构建健壮、可维护 REST API 的基础实践，也避免了前端被迫适配非标准命名的耦合风险。
