欢迎加入
「易源易彩交流群」
「易源易彩交流群」
QQ扫码进群
（QQ群号：860213912）
注册得好礼
新用户微信注册享20元算力, >立即注册
关注公众号得算力
新用户关注易彩微信公众号享20元算力，
邀请有礼
邀请1人得5元算力，可累计叠加, 查看规则
在Spring框架的日常开发中，开发者可能会遇到org.springframework.http.converter.HttpMessageNotReadableException异常，这通常是由于请求的JSON数据格式不正确或数据类型不匹配所致。本文将深入探讨这一异常的成因，并提供一系列解决方案，以便快速定位和解决该问题。我们将重点关注Spring框架中的HTTP消息转换、JSON解析错误和异常处理。当Spring处理HTTP请求时，它依赖于转换器来解析请求体中的数据。如果转换器遇到无法解析的JSON数据，就会抛出HttpMessageNotReadableException异常。文章将介绍如何通过添加自定义异常处理器来捕获并处理这些异常，从而提高应用程序的健壮性和用户体验。
Spring框架, JSON解析, 异常处理, HTTP请求, 数据转换
在Spring框架中，HTTP消息转换器（HttpMessageConverter）扮演着至关重要的角色。它们负责将HTTP请求中的数据转换为Java对象，以及将Java对象转换为HTTP响应中的数据。这一过程确保了数据在客户端和服务器之间的顺利传输。Spring框架内置了多种消息转换器，如MappingJackson2HttpMessageConverter用于处理JSON数据，StringHttpMessageConverter用于处理字符串数据等。
当一个HTTP请求到达Spring控制器时，Spring会根据请求的内容类型（Content-Type）选择合适的HttpMessageConverter来解析请求体中的数据。例如，如果请求的内容类型是application/json，Spring会选择MappingJackson2HttpMessageConverter来解析JSON数据。如果解析过程中遇到任何问题，比如JSON格式不正确或数据类型不匹配，HttpMessageConverter会抛出HttpMessageNotReadableException异常。
JSON（JavaScript Object Notation）是一种轻量级的数据交换格式，广泛用于Web应用中。在Spring框架中，JSON数据的解析主要依赖于Jackson库，这是Spring默认使用的JSON处理库。当客户端发送一个包含JSON数据的HTTP请求时，Spring会调用MappingJackson2HttpMessageConverter来解析这些数据。
解析过程大致分为以下几个步骤：
MappingJackson2HttpMessageConverter使用Jackson库将请求体中的JSON字符串解析为Java对象。Jackson库会逐个解析JSON字段，并尝试将其映射到相应的Java对象属性。MappingJackson2HttpMessageConverter会抛出HttpMessageNotReadableException异常。通过理解这一过程，开发者可以更好地诊断和解决HttpMessageNotReadableException异常。例如，可以通过检查客户端发送的JSON数据格式是否正确，或者调整Java对象的属性类型来避免类型不匹配的问题。此外，添加自定义异常处理器可以进一步增强应用程序的健壮性，提供更友好的错误提示信息，从而提升用户体验。
在实际开发中，HttpMessageNotReadableException异常最常见的原因之一是JSON数据格式错误。这种错误通常发生在客户端发送的JSON数据不符合预期的格式，导致Spring框架无法正确解析。以下是一个具体的案例分析，帮助开发者更好地理解和解决这类问题。
假设我们有一个简单的用户注册接口，客户端需要发送一个包含用户名和密码的JSON对象。接口的请求体格式如下：
{
"username": "exampleUser",
"password": "examplePassword"
}
某天，开发团队收到了用户的反馈，称在注册时总是收到“Bad Request”错误。经过初步排查，发现服务器日志中记录了HttpMessageNotReadableException异常。进一步查看客户端发送的请求体，发现如下内容：
{
"username": "exampleUser",
"password": examplePassword
}
从上述请求体可以看出，password字段没有被正确地用引号包围，导致JSON格式错误。Spring框架在尝试解析这个请求体时，无法识别examplePassword，因为JSON规范要求所有字符串值必须用双引号包围。因此，MappingJackson2HttpMessageConverter在解析过程中抛出了HttpMessageNotReadableException异常。
HttpMessageNotReadableException异常，并返回更友好的错误提示信息，如“请求体格式错误，请检查JSON数据”。除了JSON数据格式错误外，数据类型不匹配也是导致HttpMessageNotReadableException异常的常见原因。当客户端发送的数据类型与后端期望的数据类型不一致时，Spring框架无法正确解析请求体，从而引发异常。以下是一些常见的数据类型不匹配问题及其解决方案。
假设我们有一个更新用户信息的接口，客户端需要发送一个包含用户ID和生日的JSON对象。接口的请求体格式如下：
{
"userId": 123,
"birthday": "1990-01-01"
}
某天，开发团队发现用户在更新生日时总是失败。查看服务器日志，发现HttpMessageNotReadableException异常。进一步检查客户端发送的请求体，发现如下内容：
{
"userId": "123",
"birthday": "01/01/1990"
}
从上述请求体可以看出，userId字段被发送为字符串，而后端期望的是整数类型。同时，birthday字段的日期格式与后端期望的yyyy-MM-dd格式不一致。
userId转换为整数，将birthday格式化为yyyy-MM-dd。HttpMessageNotReadableException异常，并返回详细的错误提示信息，如“userId必须为整数”、“birthday格式应为yyyy-MM-dd”。当遇到HttpMessageNotReadableException异常时，开发者需要能够快速解读异常信息，准确定位问题所在。以下是一些常见的异常信息及其解读方法。
int from String "123": not a valid Integer value：表示字符串值无法转换为整数类型。int：检查请求体中的数据类型，确保字符串值可以正确转换为目标类型。例如，将字符串转换为整数。通过以上方法，开发者可以快速定位和解决HttpMessageNotReadableException异常，提高应用程序的稳定性和用户体验。
在Spring框架中，自定义异常处理器是提高应用程序健壮性和用户体验的重要手段。通过编写自定义异常处理器，开发者可以捕获并处理特定的异常，提供更加友好和详细的错误信息。以下是编写自定义异常处理器的具体步骤：
@ControllerAdvice注解标记该类。@ControllerAdvice注解使得该类可以处理所有控制器中的异常。@ControllerAdvice
public class GlobalExceptionHandler {
// 异常处理方法
}
@ExceptionHandler注解标记，指定要处理的异常类型。例如，处理HttpMessageNotReadableException异常的方法如下：@ExceptionHandler(HttpMessageNotReadableException.class)
@ResponseBody
public ResponseEntity<ErrorResponse> handleHttpMessageNotReadableException(HttpMessageNotReadableException ex) {
ErrorResponse errorResponse = new ErrorResponse("请求体格式错误，请检查JSON数据", ex.getMessage());
return new ResponseEntity<>(errorResponse, HttpStatus.BAD_REQUEST);
}
public class ErrorResponse {
private String errorMessage;
private String detailedMessage;
public ErrorResponse(String errorMessage, String detailedMessage) {
this.errorMessage = errorMessage;
this.detailedMessage = detailedMessage;
}
// Getters and Setters
}
通过以上步骤，开发者可以有效地捕获和处理HttpMessageNotReadableException异常，提供更加友好的错误提示信息，从而提升用户体验。
在处理HttpMessageNotReadableException异常时，遵循一些最佳实践可以进一步提高应用程序的健壮性和可维护性。以下是一些推荐的最佳实践：
@ExceptionHandler(HttpMessageNotReadableException.class)
@ResponseBody
public ResponseEntity<ErrorResponse> handleHttpMessageNotReadableException(HttpMessageNotReadableException ex) {
ErrorResponse errorResponse = new ErrorResponse("请求体格式错误，请检查JSON数据", ex.getMessage() + " - " + ex.getMostSpecificCause().getMessage());
return new ResponseEntity<>(errorResponse, HttpStatus.BAD_REQUEST);
}
@ExceptionHandler(HttpMessageNotReadableException.class)
@ResponseBody
public ResponseEntity<ErrorResponse> handleHttpMessageNotReadableException(HttpMessageNotReadableException ex) {
logger.error("HttpMessageNotReadableException occurred: {}", ex.getMessage(), ex);
ErrorResponse errorResponse = new ErrorResponse("请求体格式错误，请检查JSON数据", ex.getMessage());
return new ResponseEntity<>(errorResponse, HttpStatus.BAD_REQUEST);
}
public class ApiResponse<T> {
private boolean success;
private T data;
private List<String> errors;
// Getters and Setters
}
@ExceptionHandler(HttpMessageNotReadableException.class)
@ResponseBody
public ResponseEntity<ApiResponse<Void>> handleHttpMessageNotReadableException(HttpMessageNotReadableException ex) {
ApiResponse<Void> response = new ApiResponse<>();
response.setSuccess(false);
response.getErrors().add("请求体格式错误，请检查JSON数据");
response.getErrors().add(ex.getMessage());
return new ResponseEntity<>(response, HttpStatus.BAD_REQUEST);
}
良好的异常处理不仅能够提高应用程序的健壮性，还能显著提升用户体验。以下是一些具体的影响：
ApiResponse对象，用户可以始终期待相同的响应结构，无论是在成功还是失败的情况下。通过以上措施，开发者不仅可以提高应用程序的健壮性和稳定性，还能显著提升用户体验，使应用程序更加用户友好和可靠。
在处理HTTP请求时，确保客户端发送的数据格式正确且类型匹配是至关重要的。数据验证和类型检查不仅是防止HttpMessageNotReadableException异常的有效手段，还能提高应用程序的整体质量和用户体验。以下是一些实用的数据验证和类型检查方法。
Spring框架提供了丰富的注解，可以帮助开发者在控制器层进行数据验证。这些注解可以应用于请求参数、路径变量和请求体中的对象属性，确保数据符合预期的格式和类型。
例如，假设我们有一个用户注册接口，需要验证用户名和密码的格式：
@PostMapping("/register")
public ResponseEntity<String> registerUser(@Valid @RequestBody User user) {
userService.register(user);
return ResponseEntity.ok("User registered successfully");
}
public class User {
@NotNull
@Size(min = 3, max = 50)
private String username;
@NotNull
@Size(min = 6, max = 100)
private String password;
// Getters and Setters
}
在这个例子中，@NotNull注解确保字段不能为空，@Size注解限制字段的长度。如果客户端发送的数据不符合这些条件，Spring会自动抛出MethodArgumentNotValidException异常，并返回400 Bad Request状态码。
对于更复杂的验证逻辑，可以创建自定义数据验证器。自定义验证器实现ConstraintValidator接口，并在需要验证的类或字段上使用自定义注解。
例如，假设我们需要验证用户的邮箱地址是否符合特定的格式：
@Constraint(validatedBy = EmailValidator.class)
@Target({ ElementType.FIELD })
@Retention(RetentionPolicy.RUNTIME)
public @interface ValidEmail {
String message() default "Invalid email address";
Class<?>[] groups() default {};
Class<? extends Payload>[] payload() default {};
}
public class EmailValidator implements ConstraintValidator<ValidEmail, String> {
@Override
public void initialize(ValidEmail constraintAnnotation) {
}
@Override
public boolean isValid(String email, ConstraintValidatorContext context) {
if (email == null) {
return false;
}
return email.matches("[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,}");
}
}
public class User {
@NotNull
@Size(min = 3, max = 50)
private String username;
@NotNull
@Size(min = 6, max = 100)
private String password;
@ValidEmail
private String email;
// Getters and Setters
}
通过这种方式，我们可以灵活地定义和应用复杂的验证逻辑，确保数据的完整性和一致性。
JSON Schema是一种用于描述JSON数据结构的规范，可以用来验证JSON数据的格式和类型。使用JSON Schema进行数据校验，可以提供更细粒度的控制和更强大的验证能力。
首先，定义一个JSON Schema文件，描述期望的JSON数据结构。例如，假设我们有一个用户注册接口，需要验证用户名、密码和邮箱地址：
{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {
"username": {
"type": "string",
"minLength": 3,
"maxLength": 50
},
"password": {
"type": "string",
"minLength": 6,
"maxLength": 100
},
"email": {
"type": "string",
"format": "email"
}
},
"required": ["username", "password", "email"]
}
在Spring框架中，可以使用第三方库（如json-schema-validator）来集成JSON Schema校验。以下是一个简单的示例，展示如何在控制器中使用JSON Schema进行数据校验：
import com.github.fge.jsonschema.core.exceptions.ProcessingException;
import com.github.fge.jsonschema.main.JsonSchema;
import com.github.fge.jsonschema.main.JsonSchemaFactory;
import com.github.fge.jsonschema.main.JsonValidator;
import com.github.fge.jsonschema.core.report.ProcessingReport;
import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.databind.node.ObjectNode;
import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RestController;
import java.io.IOException;
import java.net.URL;
@RestController
public class UserController {
private final ObjectMapper objectMapper = new ObjectMapper();
private final JsonSchemaFactory factory = JsonSchemaFactory.byDefault();
private final JsonSchema schema;
public UserController() throws IOException, ProcessingException {
URL schemaUrl = getClass().getResource("/user-schema.json");
JsonSchema jsonSchema = factory.getJsonSchema(schemaUrl);
this.schema = jsonSchema;
}
@PostMapping("/register")
public ResponseEntity<String> registerUser(@RequestBody String requestBody) {
try {
ObjectNode json = objectMapper.readValue(requestBody, ObjectNode.class);
ProcessingReport report = schema.validate(json);
if (!report.isSuccess()) {
StringBuilder errorMessage = new StringBuilder();
for (ProcessingMessage pm : report) {
errorMessage.append(pm.getMessage()).append("\n");
}
return ResponseEntity.status(HttpStatus.BAD_REQUEST).body(errorMessage.toString());
}
// 处理注册逻辑
return ResponseEntity.ok("User registered successfully");
} catch (IOException | ProcessingException e) {
return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body("Internal server error");
}
}
}
在这个示例中，我们首先加载JSON Schema文件，并在控制器中使用JsonSchema对象进行数据校验。如果校验失败，返回400 Bad Request状态码和详细的错误信息。
通过使用JSON Schema进行数据校验，开发者可以确保客户端发送的数据符合预期的格式和类型，从而有效避免HttpMessageNotReadableException异常的发生，提高应用程序的健壮性和用户体验。
在Spring框架的日常开发中，HttpMessageNotReadableException异常的出现往往让人头疼不已。为了帮助开发者更好地理解和解决这一问题，我们通过几个经典案例来深入剖析其成因和解决方案。
背景：假设我们有一个用户注册接口，客户端需要发送一个包含用户名和密码的JSON对象。接口的请求体格式如下：
{
"username": "exampleUser",
"password": "examplePassword"
}
问题描述：某天，开发团队收到了用户的反馈，称在注册时总是收到“Bad Request”错误。经过初步排查，发现服务器日志中记录了HttpMessageNotReadableException异常。进一步查看客户端发送的请求体，发现如下内容：
{
"username": "exampleUser",
"password": examplePassword
}
问题分析：从上述请求体可以看出，password字段没有被正确地用引号包围，导致JSON格式错误。Spring框架在尝试解析这个请求体时，无法识别examplePassword，因为JSON规范要求所有字符串值必须用双引号包围。因此，MappingJackson2HttpMessageConverter在解析过程中抛出了HttpMessageNotReadableException异常。
解决方案：
HttpMessageNotReadableException异常，并返回更友好的错误提示信息，如“请求体格式错误，请检查JSON数据”。背景：假设我们有一个更新用户信息的接口，客户端需要发送一个包含用户ID和生日的JSON对象。接口的请求体格式如下：
{
"userId": 123,
"birthday": "1990-01-01"
}
问题描述：某天，开发团队发现用户在更新生日时总是失败。查看服务器日志，发现HttpMessageNotReadableException异常。进一步检查客户端发送的请求体，发现如下内容：
{
"userId": "123",
"birthday": "01/01/1990"
}
问题分析：从上述请求体可以看出，userId字段被发送为字符串，而后端期望的是整数类型。同时，birthday字段的日期格式与后端期望的yyyy-MM-dd格式不一致。
解决方案：
userId转换为整数，将birthday格式化为yyyy-MM-dd。HttpMessageNotReadableException异常，并返回详细的错误提示信息，如“userId必须为整数”、“birthday格式应为yyyy-MM-dd”。在处理HTTP请求时，确保JSON数据的正确性和类型匹配是至关重要的。以下是一些高效的方法，帮助开发者快速定位和解决JSON相关的问题。
Spring框架提供了丰富的注解，可以帮助开发者在控制器层进行数据验证。这些注解可以应用于请求参数、路径变量和请求体中的对象属性，确保数据符合预期的格式和类型。
例如，假设我们有一个用户注册接口，需要验证用户名和密码的格式：
@PostMapping("/register")
public ResponseEntity<String> registerUser(@Valid @RequestBody User user) {
userService.register(user);
return ResponseEntity.ok("User registered successfully");
}
public class User {
@NotNull
@Size(min = 3, max = 50)
private String username;
@NotNull
@Size(min = 6, max = 100)
private String password;
// Getters and Setters
}
在这个例子中，@NotNull注解确保字段不能为空，@Size注解限制字段的长度。如果客户端发送的数据不符合这些条件，Spring会自动抛出MethodArgumentNotValidException异常，并返回400 Bad Request状态码。
对于更复杂的验证逻辑，可以创建自定义数据验证器。自定义验证器实现ConstraintValidator接口，并在需要验证的类或字段上使用自定义注解。
例如，假设我们需要验证用户的邮箱地址是否符合特定的格式：
@Constraint(validatedBy = EmailValidator.class)
@Target({ ElementType.FIELD })
@Retention(RetentionPolicy.RUNTIME)
public @interface ValidEmail {
String message() default "Invalid email address";
Class<?>[] groups() default {};
Class<? extends Payload>[] payload() default {};
}
public class EmailValidator implements ConstraintValidator<ValidEmail, String> {
@Override
public void initialize(ValidEmail constraintAnnotation) {
}
@Override
public boolean isValid(String email, ConstraintValidatorContext context) {
if (email == null) {
return false;
}
return email.matches("[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,}");
}
}
public class User {
@NotNull
@Size(min = 3, max = 50)
private String username;
@NotNull
@Size(min = 6, max = 100)
private String password;
@ValidEmail
private String email;
// Getters and Setters
}
通过这种方式，我们可以灵活地定义和应用复杂的验证逻辑，确保数据的完整性和一致性。
JSON Schema是一种用于描述JSON数据结构的规范，可以用来验证JSON数据的格式和类型。使用JSON Schema进行数据校验，可以提供更细粒度的控制和更强大的验证能力。
定义JSON Schema：首先，定义一个JSON Schema文件，描述期望的JSON数据结构。例如，假设我们有一个用户注册接口，需要验证用户名、密码和邮箱地址：
{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {
"username": {
"type": "string",
"minLength": 3,
"maxLength": 50
},
"password": {
"type": "string",
"minLength": 6,
"maxLength": 100
},
"email": {
"type": "string",
"format": "email"
}
},
"required": ["username", "password", "email"]
}
使用JSON Schema进行校验：在Spring框架中，可以使用第三方库（如json-schema-validator）来集成JSON Schema校验。以下是一个简单的示例，展示如何在控制器中使用JSON Schema进行数据校验：
import com.github.fge.jsonschema.core.exceptions.ProcessingException;
import com.github.fge.jsonschema.main.JsonSchema;
import com.github.fge.jsonschema.main.JsonSchemaFactory;
import com.github.fge.jsonschema.main.JsonValidator;
import com.github.fge.jsonschema.core.report.ProcessingReport;
import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.databind.node.ObjectNode;
import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RestController;
import java.io.IOException;
import java.net.URL;
@RestController
public class UserController {
private final ObjectMapper objectMapper = new ObjectMapper();
private final JsonSchemaFactory factory = JsonSchemaFactory.byDefault();
private final JsonSchema schema;
public UserController() throws IOException, ProcessingException {
URL schemaUrl = getClass().getResource("/user-schema.json");
JsonSchema jsonSchema = factory.getJsonSchema(schemaUrl);
this.schema = jsonSchema;
}
@PostMapping("/register")
public ResponseEntity<String> registerUser(@RequestBody String requestBody) {
try {
ObjectNode json = objectMapper.readValue(requestBody, ObjectNode.class);
ProcessingReport report = schema.validate(json);
if (!report.isSuccess()) {
StringBuilder errorMessage = new StringBuilder();
for (ProcessingMessage pm : report) {
errorMessage.append(pm.getMessage()).append("\n");
}
return ResponseEntity.status(HttpStatus.BAD_REQUEST).body(errorMessage.toString());
}
// 处理注册逻辑
return ResponseEntity.ok("User registered successfully");
} catch (IOException | ProcessingException e) {
return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body("Internal server error");
}
}
}
在这个示例中，我们首先加载JSON Schema文件，并在控制器中使用JsonSchema对象进行数据校验。如果校验失败，返回400 Bad Request状态码和详细的错误信息。
通过使用JSON Schema进行数据校验，开发者可以确保客户端发送的数据符合预期的格式和类型，从而有效避免HttpMessageNotReadableException异常的发生，提高应用程序的健壮性和用户体验。
本文深入探讨了在Spring框架的日常开发中，开发者可能遇到的org.springframework.http.converter.HttpMessageNotReadableException异常。通过分析这一异常的成因，包括JSON数据格式错误和数据类型不匹配，我们提供了一系列解决方案，如客户端验证、服务端容错和自定义异常处理器的设计与应用。此外，本文还介绍了如何通过数据验证注解和JSON Schema进行数据校验，以提高JSON解析的准确性和效率。通过这些方法，开发者可以快速定位和解决HttpMessageNotReadableException异常，提高应用程序的健壮性和用户体验。希望本文的内容能为开发者在处理HTTP请求和JSON数据时提供有价值的参考和指导。