Java REST接口返回400错误：方法失效问题排查与修复

问题根源分析 #

你的代码触发400错误主要有两个核心原因：

• @PostMapping注解参数误用：你用params = MediaType.APPLICATION_JSON_UTF8_VALUE来指定请求格式，但params属性的作用是限定请求必须携带指定URL参数，而非声明接口接收的请求体类型，这会导致Spring无法正确识别JSON请求体，直接返回400。
• 请求体反序列化冲突：前端传入的JSON可能包含id或author字段，但你的业务逻辑是通过URL路径中的id获取User实例来创建Message，请求体中的冗余字段会让Spring在反序列化Message对象时出现匹配异常，引发400错误。

修复后的代码实现 #

修正后的Controller方法 #

import org.springframework.web.server.ResponseStatusException;
import org.springframework.http.HttpStatus;
import lombok.Data;

@PostMapping(value = "/message/{id}", consumes = MediaType.APPLICATION_JSON_VALUE)
public Message createMessage(@RequestBody MessageRequestDTO messageRequest, @PathVariable("id") Long id) {
    // 处理用户不存在的情况，返回明确的404错误
    User author = userRepository.findById(id)
            .orElseThrow(() -> new ResponseStatusException(HttpStatus.NOT_FOUND, "用户不存在"));
    Message message = new Message(messageRequest.getText(), author);
    return messageRepository.save(message);
}

// 新增DTO类，仅接收前端需要传递的字段，避免反序列化冲突
@Data
public class MessageRequestDTO {
    private String text;
}

实体类保持原代码即可 #

@Entity
@NoArgsConstructor
@Getter
@Setter
public class Message {

    @Id
    @GeneratedValue(strategy=GenerationType.AUTO)
    private Integer id;
    private String text;
    @ManyToOne(fetch = FetchType.EAGER)
    @JoinColumn(name = "user_id")
    private User author;

    public Message(String text, User author) {
        this.text = text;
        this.author = author;
    }
}

关键修复点说明 #

1. 修正请求格式声明：用consumes = MediaType.APPLICATION_JSON_VALUE替代params，明确告诉接口只接收JSON格式的请求体。
2. 使用DTO隔离请求体：通过MessageRequestDTO只接收前端必要的text字段，避免请求体中的id、author等冗余字段干扰反序列化过程，同时符合REST接口的单一职责原则。
3. 优化异常处理：将userRepository.findById(id).get()替换为orElseThrow，当用户不存在时返回404错误，避免未捕获的NoSuchElementException导致500服务器错误。
4. 简化业务逻辑：直接在Controller方法内完成Message的创建与保存，去掉不必要的私有方法，提升代码可读性。

前端请求规范示例 #

确保前端发送的POST请求符合以下格式：

• 请求URL：POST /message/1（1为目标用户ID，替换为实际值）
• 请求头：Content-Type: application/json
• 请求体：

{
    "text": "这是一条测试消息"
}

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