Spring Boot Kotlin数据类默认值在REST控制器中未初始化问题

1. 修正更新逻辑（核心问题） #

当前直接保存@RequestBody反序列化得到的BookItem对象，会导致未在请求体中传递的字段被设置为null或默认值，覆盖数据库原有数据，甚至触发非空约束错误。正确的更新流程应该是先加载原有实体，再合并更新字段：

修改服务层的updateBook方法：

fun updateBook(updatedBookItem: BookItem): BookItem {
    // 从数据库获取原有实体
    val existingBookItem = bookItemRepository.findById(updatedBookItem.id!!)
        .orElseThrow { IllegalArgumentException("BookItem not found with id: ${updatedBookItem.id}") }
    
    // 仅更新请求体中传递的非空字段
    updatedBookItem.book?.let { existingBookItem.book = it }
    updatedBookItem.format?.let { existingBookItem.format = it }
    updatedBookItem.barcode?.let { existingBookItem.barcode = it }
    updatedBookItem.label?.let { existingBookItem.label = it }
    updatedBookItem.referenceOnly?.let { existingBookItem.referenceOnly = it }
    updatedBookItem.borrowed?.let { existingBookItem.borrowed = it }
    updatedBookItem.dueDate?.let { existingBookItem.dueDate = it }
    updatedBookItem.price?.let { existingBookItem.price = it }
    updatedBookItem.status?.let { existingBookItem.status = it }
    updatedBookItem.dateOfPurchase?.let { existingBookItem.dateOfPurchase = it }
    updatedBookItem.publicationDate?.let { existingBookItem.publicationDate = it }
    
    // 保存合并后的实体
    return bookItemRepository.save(existingBookItem)
}

如果觉得手动赋值繁琐，可以使用MapStruct或ModelMapper等工具实现字段自动合并。

2. 确保Jackson正确处理Kotlin数据类默认参数 #

即使修正了更新逻辑，在创建实体（POST请求）时，仍需要Jackson正确应用数据类的默认参数。确保以下配置：

引入Jackson Kotlin模块 #

在构建文件中添加依赖：

Gradle

implementation 'com.fasterxml.jackson.module:jackson-module-kotlin'

Maven

<dependency>
    <groupId>com.fasterxml.jackson.module</groupId>
    <artifactId>jackson-module-kotlin</artifactId>
</dependency>

Spring Boot会自动注册该模块，确保Jackson能够识别Kotlin数据类的默认参数，在请求体未传递字段时自动填充默认值。

优化JPA实体配置 #

Kotlin数据类作为JPA实体，需要无参构造函数（JPA规范要求），推荐使用kotlin-jpa插件自动生成：
在build.gradle中启用插件：

plugins {
    id 'org.jetbrains.kotlin.plugin.jpa' version '1.9.20'
}

该插件会自动为JPA实体生成无参构造函数，无需手动编写。

如果不想使用插件，可以手动添加次级构造：

@Entity
@Table(name = "book_item")
data class BookItem (
    // ... 现有字段 ...
) {
    // JPA需要的无参构造
    constructor() : this(
        book = Book(), 
        format = BookFormat.HARDCOVER,
        barcode = "0000000000000",
        referenceOnly = false,
        status = BookStatus.AVAILABLE,
        dateOfPurchase = Date(),
        publicationDate = Date()
    )
}

注意：关联的Book实体也需要满足JPA的构造要求。

3. 额外建议 #

• 对于非空且有默认值的字段，确保数据库表结构的默认值与数据类一致，避免数据不一致。
• 使用@NotNull等校验注解，确保客户端传递必要的字段（如book），避免反序列化时出现非空字段为null的情况。

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