在 spring boot 中捕获 gson 解析异常,核心做法是在全局异常处理器 @controlleradvice 中拦截 com.google.gson.jsonsyntaxexception。当请求体包含非法 json 时,gson 会抛出此异常,通过配置 httpmessageconverter 或手动注册异常映射,即可统一返回标准的错误响应结构。

Gson 解析失败时的默认行为是什么
默认情况下,如果 Spring MVC 使用 GsonHttpMessageConverter 且未进行特殊配置,Gson 抛出 JsonSyntaxException 会导致容器返回 500 内部服务器错误,或者在某些版本中直接中断请求而不进入 Spring 的异常处理链。为了捕获它,必须确保异常被 Spring 的异常处理机制接管。

import com.google.gson.Gson;
import com.google.gson.JsonSyntaxException;
import org.springframework.http.converter.json.GsonHttpMessageConverter;
import org.springframework.stereotype.Component;
@Component
public class CustomGsonConfig {
public GsonHttpMessageConverter gsonConverter() {
GsonHttpMessageConverter converter = new GsonHttpMessageConverter();
// 关键:设置自定义的 Gson 实例或在此处配置错误处理逻辑
// 但通常 JsonSyntaxException 是在反序列化过程中抛出的
return converter;
}
}上述代码展示了如何自定义 GsonHttpMessageConverter。虽然这能控制 Gson 的行为,但捕获解析异常更通用的方式是在全局异常处理器中直接处理。当客户端发送如 {"name": } 这种非法 JSON 时,转换器会抛出 JsonSyntaxException,此时 Spring 的 ExceptionHandler 可以拦截它。
如何在 ControllerAdvice 中统一处理该异常
通过在 @RestControllerAdvice 类中定义 @ExceptionHandler(JsonSyntaxException.class) 方法,可以拦截所有由 Gson 解析失败引发的异常。该方法应返回一个统一的错误响应对象,例如包含错误码和消息的 JSON 结构,从而避免将堆栈信息暴露给前端。

import com.google.gson.JsonSyntaxException;
import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;
@RestControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(JsonSyntaxException.class)
public ResponseEntity<ErrorResponse> handleJsonSyntaxException(JsonSyntaxException ex) {
ErrorResponse error = new ErrorResponse(400, "Invalid JSON format: " + ex.getMessage());
return ResponseEntity.badRequest().body(error);
}
}
class ErrorResponse {
private int code;
private String message;
// 构造函数、getter、setter 省略
}这段代码实现了具体的异常捕获逻辑。当 JsonSyntaxException 发生时,handleJsonSyntaxException 方法会被调用,返回 HTTP 400 状态码和自定义的错误描述。这种方式确保了无论哪个 Controller 发生 JSON 解析错误,都会得到一致的响应格式。需要注意的是,如果使用了 Jackson 作为默认的 JSON 转换器,则需捕获 HttpMessageNotReadableException 而非 Gson 的异常,本方案仅针对明确使用 Gson 的场景。
当 Gson 遇到嵌套对象缺失字段时会返回什么
当 Gson 解析 JSON 且目标 Java 对象中存在必填字段(即没有默认值且非 Optional)缺失时,Gson 默认不会抛出异常,而是将该字段设为 null 或默认值。但如果启用了 setStrictness(Strictness.LENIENT) 之外的严格模式,或者使用了 ExclusionStrategy 等高级特性,行为可能不同。通常情况下,简单的字段缺失不会导致解析异常,只有格式错误才会触发 JsonSyntaxException。


















