SpringBoot接口@RequestBody接收请求时username参数为null

调用POST http://localhost:8080/auth/signin接口完成用户认证时，无论提交application/json还是application/xml格式的请求体，@RequestBody绑定的AccountCredentialsVO实例中password字段可正常解析获取，username字段始终为null。

该问题属于请求体反序列化阶段字段映射失败，JSON、XML两种格式同时失效可排除单格式解析器配置错误，优先排查以下诱因：

• AccountCredentialsVO类不符合JavaBean属性写入规范：手动编写setter方法时方法名错误，比如写成setusername（set后属性名首字母未大写）、setUserName（属性名单词首字母大写和username字段不匹配），或setter内部赋值逻辑写错，未将入参赋值给类的username字段。如果使用Lombok生成访问方法，字段名存在不规则大小写（比如uSername、Username）会导致Lombok生成的setter方法名不符合预期，无法被Jackson识别。
• 请求体字段名和实体类字段名无显式映射：比如请求提交的字段是userName（小驼峰第二个单词首字母大写）、user_name（下划线命名），但Jackson默认的标准驼峰匹配策略无法对应到username字段，且未加注解做显式映射。
• 低概率诱因：username字段被@JsonIgnore等注解标记为反序列化忽略，或自定义的反序列化规则、全局Jackson配置中排除了username字段。

按优先级依次排查修复：

• 校准AccountCredentialsVO类的JavaBean规范
  不使用Lombok的标准写法参考如下，确保setter/getter方法名、赋值逻辑完全正确：

  public class AccountCredentialsVO {
      private String username;
      private String password;
  
      public String getUsername() {
          return username;
      }
  
      // 方法名必须为setUsername，入参正确赋值给类字段
      public void setUsername(String username) {
          this.username = username;
      }
  
      public String getPassword() {
          return password;
      }
  
      public void setPassword(String password) {
          this.password = password;
      }
  }
  

  如果使用Lombok，直接在类上添加@Data注解即可，不要给username字段添加任何序列化忽略相关注解，写法参考：

  import lombok.Data;
  
  @Data
  public class AccountCredentialsVO {
      private String username;
      private String password;
  }
  

• 校准请求体字段与实体类的映射关系
  如果请求提交的字段名不是标准全小驼峰的username，需要在字段上添加显式映射注解，同时兼容JSON、XML两种格式解析，写法参考：

  import com.fasterxml.jackson.annotation.JsonProperty;
  import com.fasterxml.jackson.dataformat.xml.annotation.JacksonXmlProperty;
  import lombok.Data;
  
  @Data
  public class AccountCredentialsVO {
      // 示例：兼容请求传userName字段的场景
      @JsonProperty("userName")
      @JacksonXmlProperty(localName = "userName")
      private String username;
      private String password;
  }
  

  符合默认映射规则的JSON请求示例：

  {
      "username": "testAccount",
      "password": "testPass123"
  }
  

  符合默认映射规则的XML请求示例：

  <AccountCredentialsVO>
      <username>testAccount</username>
      <password>testPass123</password>
  </AccountCredentialsVO>
  

• 校准Controller层接口写法
  确保接口方法正确标注请求映射注解，@RequestBody注解直接加在参数前，无多余的自定义参数绑定注解干扰，标准写法参考：

  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.RequestMapping;
  import org.springframework.web.bind.annotation.RestController;
  
  @RestController
  @RequestMapping("/auth")
  public class AuthController {
      @PostMapping("/signin")
      public ResponseEntity<?> signin(@RequestBody AccountCredentialsVO credentials) {
          // 认证业务逻辑
          return ResponseEntity.ok().build();
      }
  }
  

• 校准pom.xml依赖配置
  不要手动替换SpringBoot官方starter自带的Jackson版本，避免版本冲突；XML格式解析需要引入官方的jackson-dataformat-xml依赖，不要使用老旧的第三方XML解析器做请求体绑定，核心依赖参考：

  <!-- Web starter 自带JSON解析相关依赖 -->
  <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-web</artifactId>
  </dependency>
  <!-- 引入Jackson XML解析支持 -->
  <dependency>
      <groupId>com.fasterxml.jackson.dataformat</groupId>
      <artifactId>jackson-dataformat-xml</artifactId>
  </dependency>
  

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