Spring Boot为何无法用单个接口同时添加单个或多个用户？

问题根源：JSON反序列化的类型推断缺失 #

当你用@RequestBody Object接收请求体时，Spring Boot底层的Jackson序列化框架无法自动推断JSON对应的具体Java类型：

• 若请求是单个用户的JSON对象，Jackson会默认将其反序列化为LinkedHashMap<String, Object>，而非你的User类实例
• 若请求是用户列表的JSON数组，Jackson会反序列化为ArrayList<LinkedHashMap<String, Object>>，而非List<User>

这直接导致你代码里的instanceof判断完全失效：

• request instanceof User永远为false，因为实际类型是LinkedHashMap
• 即使是列表场景，循环里的(User) obj强制转换也会抛出ClassCastException，最终触发500服务器错误

你的代码中的具体问题 #

先看你尝试的控制器代码：

// Save a list of users or a single user
@PostMapping()
public void save(@RequestBody Object request){
    if(request instanceof List<?>){
        List<?> users = (List<?>) request;
        // It will iterate through each object in the list to add the user
        for(Object obj : users){
            repository.save((User) obj); // 强制转换失败，obj实际是LinkedHashMap
        }
    }
    else if (request instanceof Usuario){ // 类名拼写错误，且实际类型不符，判断永远不成立
        repository.save((User) request);
    }
}

另外你的Repository层也存在两处明显错误：

@Repository
public class UserRepository {

    private List<User> users = new ArrayList<>();

    public UsuarioRepository() { // 构造函数名与类名不一致，应为UserRepository
        users.add(new User("jonh","password"));
        users.add(new User("frank","masterpass"));
    }
    public void save(User user){
        System.out.println("SAVE - Receiving the user at the repository layer");
        System.out.println(user);
        user.add(user); // 错误：应为users.add(user)，User实体类无add方法
    }

// rest of the code...
}

推荐方案的合理性 #

拆分两个接口是更符合RESTful设计原则的方案：

@RestController
@RequestMapping("/users")
public class UserController {

    @Autowired
    private UserRepository repository;

    // 处理单个用户添加
    @PostMapping
    public void saveOne(@RequestBody User user) {
        repository.save(user);
    }

    // 处理批量用户添加
    @PostMapping("/list")
    public void saveAll(@RequestBody List<User> users) {
        for (User user : users) {
            repository.save(user);
        }
        // 优化建议：如果是Spring Data JPA的Repository，直接调用saveAll方法更高效
        // repository.saveAll(users);
    }

// rest of the code...
}

• 明确指定@RequestBody的目标类型后，Jackson能精准完成JSON到Java对象的反序列化，彻底避免类型转换错误
• 接口语义清晰，单个接口只处理单一职责，便于维护和调试
• 批量添加场景可直接利用Spring Data Repository的saveAll方法，提升性能

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