诡异的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，不过他这篇里的命名不太规范。