Exposed框架insertIgnore方法未插入数据问题求助

问题分析与解决方案 #

1. 未定义唯一约束导致insertIgnore逻辑不生效 #

insertIgnore的核心是当插入记录触发唯一约束/主键冲突时跳过插入。你的表目前仅依赖IntIdTable自带的id主键，若要避免ownerId、driverUUID、partnerUUID的组合重复，必须给这三个字段添加联合唯一约束——否则insertIgnore会认为无冲突，要么正常插入（若你误以为已有约束），要么因已有符合约束的条目导致插入被忽略（若你期望插入新数据）。

修改表结构添加联合唯一约束：

object PartnerOwnerMappingTable : IntIdTable("partner_owner_mapping") {
  val ownerId = integer("owner_id")
  val driverUUID = uuid("driver_uuid")
  val partnerUUID = uuid("partner_uuid")

  val createdAt = timestampWithoutTZAsInstant("created_at")
  val updatedAt = timestampWithoutTZAsInstant("updated_at")

  // 添加联合唯一约束
  init {
    uniqueIndex(ownerId, driverUUID, partnerUUID)
  }
}

2. 操作未包裹在事务中 #

Exposed的所有数据库操作必须在transaction块内执行，否则不会提交到数据库。检查代码是否遗漏事务包裹：

正确执行示例：

transaction {
  PartnerOwnerMappingTable.insertIgnore {
    it[this.ownerId] = record.ownerId
    it[this.driverUUID] = record.driverUUID
    it[this.partnerUUID] = record.partnerUUID
    it[this.createdAt] = Instant.now()
    it[this.updatedAt] = Instant.now()
  }
}

3. 数据库适配问题 #

不同数据库对"忽略重复插入"的语法支持不同：

• MySQL/MariaDB原生支持INSERT IGNORE
• PostgreSQL需用ON CONFLICT DO NOTHING语法

Exposed的insertIgnore在PostgreSQL下可能无法自动适配，需改用insert配合onConflict明确指定冲突约束：

PostgreSQL适配代码：

transaction {
  PartnerOwnerMappingTable.insert {
    it[this.ownerId] = record.ownerId
    it[this.driverUUID] = record.driverUUID
    it[this.partnerUUID] = record.partnerUUID
    it[this.createdAt] = Instant.now()
    it[this.updatedAt] = Instant.now()
  }.onConflict(ownerId, driverUUID, partnerUUID) {
    doNothing()
  }
}

4. 字段值不符合数据库约束 #

检查record中的字段值是否合法：

• 确保ownerId不为null且是有效整数
• 确保driverUUID和partnerUUID是有效UUID实例（而非空字符串或null）

可给字段添加非空约束提前拦截无效数据：

val ownerId = integer("owner_id").notNull()
val driverUUID = uuid("driver_uuid").notNull()
val partnerUUID = uuid("partner_uuid").notNull()

5. 日志排查 #

开启Exposed的SQL日志，查看实际执行的SQL语句和参数，确认逻辑是否符合预期：

// 初始化Exposed时开启日志
Database.connect(...)
TransactionManager.defaultDatabase.defaultConnection.logger = Slf4jSqlDebugLogger

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