Angular请求返回HttpMessageNotReadableException而非BeanPropertyBindingResult问题

核心原因 #

你的问题本质是两种请求的参数解析机制差异：

• JUnit测试用param()提交的是表单格式数据（application/x-www-form-urlencoded），Spring通过ServletRequestDataBinder做参数绑定，当无法将字符串转换为Double时，会自动把错误存入BeanPropertyBindingResult，再通过@Valid校验触发错误返回。
• Angular发送的是JSON格式请求（application/json），Spring用Jackson的MappingJackson2HttpMessageConverter解析请求体，一旦遇到无法转换为Double的字符串（如foo），会直接抛出HttpMessageNotReadableException，此时@Valid校验还没执行，自然不会生成BeanPropertyBindingResult。

正确解决方法 #

要让Angular请求和JUnit测试返回一致的结果，推荐两种方案：

方案1：调整前端请求格式（简单直接）

让Angular发送表单格式的请求，和JUnit测试的参数绑定逻辑对齐，自动生成BeanPropertyBindingResult：

update(project: Project): Observable<EntityResponseType> {
  const copy = this.convert(project);
  // 构建表单数据
  const formData = new FormData();
  Object.keys(copy).forEach(key => {
    formData.append(key, copy[key]);
  });
  return this.http.put<Project>(this.resourceUrl, formData, { 
    observe: 'response',
    headers: new HttpHeaders({ 'Content-Type': 'application/x-www-form-urlencoded' })
  }).map((res: EntityResponseType) => this.convertResponse(res));
}

注意：如果DTO包含嵌套复杂对象，FormData无法直接处理，这种情况下更适合方案2。

方案2：全局捕获并转换JSON解析异常（通用推荐）

通过@ControllerAdvice全局捕获HttpMessageNotReadableException，解析Jackson的错误信息，手动生成BeanPropertyBindingResult并返回和校验失败一致的响应结构：

@ControllerAdvice
public class JsonParseExceptionHandler {

    private static final Pattern FIELD_PATTERN = Pattern.compile("through reference chain: .*\\[\"(.*)\"\\]");

    @ExceptionHandler(HttpMessageNotReadableException.class)
    public ResponseEntity<Map<String, Object>> handleJsonParseError(HttpMessageNotReadableException ex) {
        // 初始化BindingResult，对应你的DTO类和参数名
        BeanPropertyBindingResult bindingResult = new BeanPropertyBindingResult(new ProjectDTO(), "projectDTO");
        
        // 解析Jackson错误信息，提取错误字段
        String errorMsg = ex.getMessage();
        Matcher matcher = FIELD_PATTERN.matcher(errorMsg);
        if (matcher.find()) {
            String fieldName = matcher.group(1);
            bindingResult.addError(new FieldError(
                "projectDTO",
                fieldName,
                "必须是有效的数值",
                false, null, null, null
            ));
        } else {
            // 处理无法识别字段的通用错误
            bindingResult.addError(new ObjectError("projectDTO", "请求体格式无效"));
        }

        // 构建和@Valid校验失败一致的响应结构
        Map<String, Object> response = new HashMap<>();
        response.put("errors", bindingResult.getAllErrors().stream()
            .map(error -> {
                Map<String, String> errorDetail = new HashMap<>();
                if (error instanceof FieldError) {
                    errorDetail.put("field", ((FieldError) error).getField());
                }
                errorDetail.put("message", error.getDefaultMessage());
                return errorDetail;
            })
            .collect(Collectors.toList())
        );

        return new ResponseEntity<>(response, HttpStatus.UNPROCESSABLE_ENTITY);
    }
}

这种方案不需要修改前端代码，兼容JSON请求场景，且返回的错误结构和BeanPropertyBindingResult完全一致，前端可以复用同一套错误处理逻辑。

关于你的临时方案 #

你提到的手动创建BeanPropertyBindingResult的思路是对的，方案2就是对它的优化——通过全局异常处理器统一处理所有JSON解析错误，避免在每个接口中重复编写逻辑，同时保证错误信息的准确性和一致性。

内容的提问来源于stack exchange，提问作者tibi