Micronaut Data中如何仅在字段非空时将其纳入插入查询

要实现“createdAt字段非空时纳入插入查询，为空时省略”的需求，最佳方式是结合Micronaut Data的动态插入特性和数据库字段默认值，具体步骤如下：

1. 修改实体类 #

移除@GeneratedValue注解，添加@DynamicInsert注解，保持createdAt字段可空且默认值为null：

import io.micronaut.data.annotation.MappedEntity
import io.micronaut.data.annotation.DynamicInsert
import jakarta.persistence.Table
import java.time.Instant
import java.util.UUID

@MappedEntity
@DynamicInsert
@Table(name = "special", schema = "abc")
data class SpecialEntity(
    val uuid: UUID,
    val createdAt: Instant? = null
)

2. 配置数据库字段默认值 #

在数据库表中为created_at字段设置默认值（适配常见数据库的示例）：

• PostgreSQL: created_at TIMESTAMP WITH TIME ZONE DEFAULT CURRENT_TIMESTAMP
• MySQL: created_at DATETIME DEFAULT CURRENT_TIMESTAMP
• SQL Server: created_at DATETIME DEFAULT GETDATE()

3. 保持Repository不变 #

原有的SpecialEntityRepository无需修改，saveAll方法会自动利用动态插入特性：

import io.micronaut.data.jdbc.annotation.JdbcRepository
import io.micronaut.data.repository.kotlin.CoroutineCrudRepository
import java.util.UUID

@JdbcRepository
interface SpecialEntityRepository : CoroutineCrudRepository<SpecialEntity, UUID> {
    suspend fun saveAll(entities: Iterable<SpecialEntity>): ArrayList<SpecialEntity>
}

原理说明 #

• @DynamicInsert：指示Micronaut Data生成INSERT语句时，仅包含实体中非null的字段，自动忽略null字段。
• 数据库默认值：当INSERT语句不包含created_at字段时，数据库自动填充预设的默认时间戳；当手动设置createdAt的值时，该字段会被纳入INSERT语句，使用指定的值。

这种方式既满足了默认由数据库生成时间的需求，又支持手动传入自定义时间的场景，且无需编写复杂的自定义查询，完全适配批量插入场景。

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