Jackson字段级反序列化失效：触发400 Bad Request，类级反序列化正常

嘿，这个问题我之前帮不少开发者排查过，核心就是Jackson字段级注解的生效逻辑踩坑了！你遇到的400错误本质是：当只传用户ID时，Jackson不知道怎么把数字/字符串转成User对象，而你加在字段上的反序列化器根本没被触发——反而类级反序列化器能正常工作，是因为类级注解会被Jackson优先纳入全局反序列化流程。

先给你拆解下常见的触发失败原因：

• 你的User字段是private修饰的，Jackson默认通过setter方法做反序列化，而你只在字段上加了@JsonDeserialize，setter上没同步标注，导致字段注解被忽略。
• Jackson的默认访问策略没配置成优先读取字段，所以字段上的注解压根没被扫描到。
• 传入的JSON键名和字段名不匹配（比如你传的是userId，但字段是user），导致Jackson找不到对应的字段去应用注解。

接下来针对你的场景（只需要用户ID就能反序列化User对象），给你几个靠谱的解决方案：

方案1：让字段级注解强制生效 #

最简单的办法是给字段加上@JsonProperty，强制Jackson优先处理字段本身，而不是依赖setter：

@Entity
@Table(name = "expense")
@JsonIgnoreProperties(ignoreUnknown = true)
public class Expense implements Serializable {
    // 其他字段...
    
    @JsonProperty // 关键：告诉Jackson直接用这个字段做反序列化
    @JsonDeserialize(using = UserByIdDeserializer.class)
    private User user;
    
    // getter/setter 保留即可
}

对应的反序列化器要注意如果需要依赖注入（比如UserRepository），得确保它能被Spring管理：

public class UserByIdDeserializer extends StdDeserializer<User> {
    private final UserRepository userRepository;

    // 用构造注入拿到Repository
    public UserByIdDeserializer(UserRepository userRepository) {
        super(User.class);
        this.userRepository = userRepository;
    }

    @Override
    public User deserialize(JsonParser p, DeserializationContext ctxt) throws IOException {
        Long userId = p.getLongValue();
        // 这里根据你的需求：要么查库拿完整User，要么直接创建只带ID的对象
        return userRepository.findById(userId)
                .orElseThrow(() -> new RuntimeException("指定ID的用户不存在"));
    }
}

如果不想每个字段都加@JsonProperty，也可以全局配置Jackson的访问策略，让它默认读取字段：

@Configuration
public class JacksonConfig {
    @Bean
    public ObjectMapper objectMapper() {
        ObjectMapper mapper = new ObjectMapper();
        mapper.setVisibility(
                mapper.getSerializationConfig().getDefaultVisibilityChecker()
                        .withFieldVisibility(JsonAutoDetect.Visibility.ANY)
                        .withGetterVisibility(JsonAutoDetect.Visibility.NONE)
                        .withSetterVisibility(JsonAutoDetect.Visibility.NONE)
                        .withCreatorVisibility(JsonAutoDetect.Visibility.NONE)
        );
        return mapper;
    }
}

这样配置后，所有字段上的注解都会被Jackson识别。

方案2：用@JsonCreator构造方法（更简洁） #

如果不想写自定义反序列化器，直接给User类加一个带ID参数的构造方法，标注@JsonCreator，Jackson会自动用这个构造方法来生成User对象：

@Entity
public class User implements Serializable {
    @Id
    private Long id;
    // 其他字段...

    // 构造方法的参数名要和JSON里的键对应，或者用@JsonProperty指定
    @JsonCreator
    public User(@JsonProperty("id") Long id) {
        this.id = id;
    }

    // 别忘了JPA需要无参构造方法
    public User() {}
    
    // getter/setter...
}

这样不管你传的是"user": 123还是"user": {"id": 123}，Jackson都能正确转成User对象，完美适配你的需求。

方案3：退而求其次用类级反序列化器 #

如果字段级的方案始终踩坑，那就回到你之前的类级思路——给User类加类级反序列化器，这样所有用到User的地方都会自动生效：

@JsonDeserialize(using = UserByIdDeserializer.class)
@Entity
public class User implements Serializable {
    // ... 类内容不变
}

这种方式虽然不如字段级灵活，但胜在全局生效，不用每个字段都去加注解。

最后给你个调试小技巧：如果不确定反序列化器有没有被调用，直接在deserialize方法里加个断点或者打日志，同时把com.fasterxml.jackson的日志级别调到DEBUG，看Jackson的反序列化流程日志，一眼就能定位到哪里出问题了。

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