诡异的Spring @RequestBody驼峰命名字段映射失败为null问题记录

问题

一个非常常规的Spring Controller，代码如下：

import lombok.RequiredArgsConstructor;@Slf4j
@RestController
@RequiredArgsConstructor
@RequestMapping("/api/v1/config")
public class ConfigController {private final ConfigService configService;@ApiOperation("新增配置")@PostMapping("")public R<ConfigVo> createConfig( /*@Valid*/ @RequestBody ConfigDto dto) {return R.success(configService.createConfig(dto));}
}

DTO定义如下：

import io.swagger.annotations.ApiModel;
import lombok.*;@Data
@AllArgsConstructor
@NoArgsConstructor
@ApiModel("配置")
public class ConfigDto {@NotBlankprivate String appId;private String json;private String mark;
}

Postman模拟一次POST请求：

{"mark": "verifyUserByIdAndName","json": "{}","appId": "a_15c140390de54948af88ad9b39d1fd2f"
}

代码逻辑不对劲，然后通过断点调试，发现appId字段为null：

WTF？？？有毒吧。

现象就是驼峰命名的字段解析不出来，映射不上。

@Valid

咨询DeepSeek，一大堆废话。提取到关键词@Valid。

给这个Controller加个@Valid注解，也就是上面的代码片段里被注释的/*@Valid*/，Postman请求报错：

这个报错是框架类的封装然后返回的。说明Spring（Jackson）确实没有从Postman的request里解析映射出appId字段。

框架类代码片段：

private static final MediaType MEDIA_TYPE = new MediaType("application", "json", StandardCharsets.UTF_8);/*** JSR303 表单参数校验失败* 在Controller层使用@Valid注解*/
@ResponseStatus(HttpStatus.BAD_REQUEST)
@ExceptionHandler({MethodArgumentNotValidException.class})
public ResponseEntity<R<?>> handleMethodArgumentNotValidException(MethodArgumentNotValidException e,HttpServletRequest request) {this.logWarn(e, request, "不合法的参数异常");InvalidField invalidField = getInvalidField(e.getBindingResult());R<InvalidField> invalidFieldR = new R<>(HttpStatus.INTERNAL_SERVER_ERROR.value(), "不合法的参数异常", invalidField);return createResponseEntity(HttpStatus.BAD_REQUEST, invalidFieldR);
}private void logWarn(Exception e, HttpServletRequest request, String... msg) {String template = "[Web][有Warn被抛出] >> Warn类=[%s], URI=[%s], 消息=[%s], Warn=[%s]";log.warn(String.format(template, e.getClass().getName(), request.getRequestURI(),ArrayUtil.isEmpty(msg) ? e.getMessage() : ArrayUtil.join(msg, ","), ExceptionUtil.stacktraceToString(e)));
}private InvalidField getInvalidField(BindingResult bindingResult) {if (bindingResult == null) {return null;}FieldError fieldError = bindingResult.getFieldError();if (fieldError == null) {return null;}return InvalidField.builder().fieldName(fieldError.getField()).message(fieldError.getDefaultMessage()).build();
}protected static ResponseEntity<R<?>> createResponseEntity(HttpStatus httpStatus, R<?> body) {return ResponseEntity.status(httpStatus.value()).contentType(MEDIA_TYPE).body(body);
}@Builder
@AllArgsConstructor
@NoArgsConstructor
@Data
public static class InvalidField {private String fieldName;private String message;
}

断点调试截图：

workaround

继续询问DeepSeek，又是一大堆废话，提取到关键词@JsonProperty。

一开始并没有关注这个，因为这个注解的使用场景是字段命名不匹配。

试试吧，增加@JsonProperty("appId")，也就是

public class ConfigDto {@NotBlank@JsonProperty("appId")private String appId;
}

能解析到appId字段。

---

但是！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！

---

这两个地方的命名，明明是一模一样的啊。

分析

为啥呢？

Lombok

不是Lombok的问题，其他字段都没有问题，再说appId是一个非常常规的驼峰命名，又不是isSuccess或cAppId这种不规范命名。

编译后的代码如下，没有问题

调试

在DTO里的字段加断点调试，

在Controller层加断点调试说明@JsonProperty生效：

为啥呢？？

一个比较相似的blog，不过他这篇里的命名不太规范。

参考