Spring Boot MVC REST API响应对象序列化异常未记录问题咨询

核心原因 #

你遇到的情况本质是：Jackson序列化阶段抛出的NPE没有被Spring MVC的常规机制捕获并日志记录，具体原因有两点：

1. 序列化时机晚于控制器方法执行：控制器createUser方法已经正常返回User对象，异常是在Spring MVC后续调用Jackson序列化响应体时触发的。这个阶段的异常不会经过控制器层的@ExceptionHandler，且Spring默认配置不会主动记录该阶段的异常堆栈。
2. 日志级别限制：默认情况下，Jackson序列化和Spring MVC响应处理的日志级别是INFO或更高，DEBUG/TRACE级别未开启，所以看不到序列化异常的细节。

另外，返回HTML错误页是因为Spring MVC默认的错误处理流程没有针对application/json请求配置JSON格式的响应转换器， fallback到了HTML页面。

解决办法 #

1. 开启序列化异常的日志记录 #

在配置文件中添加日志级别配置，让控制台输出序列化阶段的异常堆栈：

# application.properties
logging.level.com.fasterxml.jackson.databind=DEBUG
logging.level.org.springframework.web.servlet.mvc.method.annotation=DEBUG

这样就能直接看到Jackson序列化时抛出的NPE，定位到具体的getter方法（比如getFullName()）。

2. 配置全局异常处理器，捕获并返回JSON错误 #

自定义@ControllerAdvice捕获Spring MVC包装后的序列化异常HttpMessageNotWritableException，记录日志并返回JSON格式的错误响应：

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.http.HttpStatus;
import org.springframework.http.MediaType;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.servlet.mvc.method.annotation.HttpMessageNotWritableException;

@ControllerAdvice
public class GlobalExceptionHandler {

    private static final Logger logger = LoggerFactory.getLogger(GlobalExceptionHandler.class);

    @ExceptionHandler(HttpMessageNotWritableException.class)
    public ResponseEntity<ErrorResponse> handleSerializationFailure(HttpMessageNotWritableException ex) {
        // 打印完整异常堆栈
        logger.error("响应体序列化失败", ex);
        // 获取原始异常（Jackson抛出的NPE）
        Throwable rootCause = ex.getRootCause();
        String errorMsg = rootCause != null ? rootCause.getMessage() : "序列化响应内容时发生错误";
        
        return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR)
                .contentType(MediaType.APPLICATION_JSON)
                .body(new ErrorResponse(HttpStatus.INTERNAL_SERVER_ERROR.value(), errorMsg));
    }

    // 错误响应DTO
    static class ErrorResponse {
        private int status;
        private String message;

        public ErrorResponse(int status, String message) {
            this.status = status;
            this.message = message;
        }

        // getter方法
        public int getStatus() {
            return status;
        }

        public String getMessage() {
            return message;
        }
    }
}

3. 修复根源NPE问题 #

针对getFullName()方法添加null判断，避免序列化时抛出异常：

public String getFullName() {
    String lastName = this.lastName == null ? "" : this.lastName;
    String firstName = this.firstName == null ? "" : this.firstName;
    return lastName + ", " + firstName;
}

或者使用Java 8+的Optional简化逻辑：

import java.util.Optional;

public String getFullName() {
    return String.format("%s, %s",
            Optional.ofNullable(lastName).orElse(""),
            Optional.ofNullable(firstName).orElse(""));
}

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