Spring Boot解决 406 错误之返回对象缺少Getter/Setter方法引发的问题

前言

在Spring Boot开发中，接口请求返回数据是系统交互的重要环节，尤其在开发RESTful风格的API接口时，保持接口数据的正常返回对于客户端访问非常重要。然而，开发过程中常常会遇到由于数据类型或返回格式问题导致的错误，其中最常见的就是406 Not Acceptable异常。本篇文章以实际的案例出发，详细分析在POST请求中产生406错误的原因，并提供针对返回数据类型的完整解决方案。

1. 问题背景

在本地环境下，我们以POST方式向Spring Boot应用发起请求，访问路径为http://localhost:8080/user/register，请求中携带了用户名和密码参数。请求信息如下所示：

POST http://localhost:8080/user/register?username=test&password=123456

当执行请求后，服务器虽然在数据库中成功创建了用户信息，注册过程在数据库层面顺利完成，但返回的数据却出现了如下异常信息：

{
   
  "timestamp": "2024-10-30T07:44:31.433+00:00",
  "status": 406,
  "error": "Not Acceptable",
  "path": "/user/register"
}

从错误信息中可以看到返回状态码为406 Not Acceptable，这表明服务器无法根据请求的内容协商出合适的响应格式，因而返回了错误信息。这一问题通常是由于请求与响应的数据格式或返回对象的序列化问题导致的。接下来我们详细分析该问题的具体原因。

2. 问题分析

在Spring Boot中，406 Not Acceptable错误通常表示服务器找不到与请求Accept头匹配的数据格式，而Accept头指明了客户端希望接受的数据类型（如JSON、XML等）。在我们的例子中，虽然请求没有明确指定Accept头，Spring Boot会默认将返回值序列化为JSON格式。因此，问题很可能出在返回数据类型的格式化上。

2.1 检查返回对象

我们在该请求的返回对象中，使用了自定义的Result类，用于封装返回的状态码、消息及数据内容，其结构大致如下：

public class Result {
   
    private int code;