如何在Spring Boot中实现客户端提供唯一ID的POST创建接口？

我正在开发一个Spring Boot应用，需要实现用于创建新Book对象的POST请求。Book的唯一标识符（nombreLibro）由客户端提供，且需在数据库中保持唯一。

以下是我的Book实体类及控制器中的createBook方法代码：

@Table("t_catalogo")
public class Book {
    @Id
    @Column("nombreLibro")
    private String nombreLibro;

    // other fields, constructors, getters and setters
}

@PostMapping("/{nombreLibro}")
public ResponseEntity<Void> createBook(@PathVariable String nombreLibro, @RequestBody Book newBook) {
    Book savedBook = newBook;
    savedBook.setNombreLibro(nombreLibro);
    try {
        bookRepository.save(savedBook);
            return ResponseEntity.status(HttpStatus.CREATED).body(newBook);

    } catch (DataIntegrityViolationException e) {
        return ResponseEntity
            .status(HttpStatus.INTERNAL_SERVER_ERROR)
            .body("An error occurred while trying to save the book.");
    }
}

当我尝试使用数据库中不存在的nombreLibro创建Book时，会收到500内部服务器错误。我认为这是因为Spring尝试更新现有Book而非创建新对象。请问我该如何修改createBook方法，以在nombreLibro不存在时创建新的Book？

你遇到500错误的核心原因不是Spring在更新对象，而是控制器方法返回类型定义错误：你声明返回ResponseEntity<Void>，但实际返回时传入了具体的body内容（newBook或错误字符串），这会导致类型不匹配，直接抛出异常。另外，当前的异常处理逻辑也不符合REST规范，下面是修正后的实现：

修正后的控制器代码 #

@PostMapping("/{nombreLibro}")
public ResponseEntity<?> createBook(@PathVariable String nombreLibro, @RequestBody Book newBook) {
    // 提前检查ID是否已存在，避免不必要的异常
    if (bookRepository.existsById(nombreLibro)) {
        return ResponseEntity.status(HttpStatus.CONFLICT)
                .body("Book with nombreLibro '" + nombreLibro + "' already exists");
    }

    newBook.setNombreLibro(nombreLibro);
    try {
        Book savedBook = bookRepository.save(newBook);
        return ResponseEntity.status(HttpStatus.CREATED).body(savedBook);
    } catch (DataIntegrityViolationException e) {
        // 处理其他数据完整性问题，如字段约束违反
        return ResponseEntity.status(HttpStatus.BAD_REQUEST)
                .body("Failed to save book: " + e.getMessage());
    }
}

关键修改点说明 #

• 修正返回类型：将ResponseEntity<Void>改为ResponseEntity<?>，允许返回不同类型的响应体，避免类型不匹配的异常。
• 提前检查ID存在性：通过existsById()方法在保存前验证ID是否已存在，直接返回409 Conflict状态码，符合REST语义，也避免进入异常分支。
• 优化异常处理：数据完整性问题属于客户端提交数据不符合要求，返回400 Bad Request而非500 Internal Server Error，更合理。
• 明确创建逻辑：Spring Data JPA的save()方法本身逻辑是：若@Id字段有值，先查询数据库，存在则更新，不存在则插入。提前检查后，确保进入save()时一定是创建新对象。

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