JpaRepository插入查询验证失败问题求助

从错误栈可以看出，问题出在你自定义的insertThirdPartyDevice方法上，核心原因有两个：

1. HQL语法不支持VALUES子句：你使用的是Spring Data JPA默认的HQL查询语法，但HQL的INSERT语句仅支持通过SELECT子句批量插入数据，不支持SQL的VALUES写法。
2. 缺少@Modifying注解：执行插入/更新/删除这类修改操作的自定义查询时，必须添加@Modifying注解，否则Spring Data JPA会把它当作查询语句去验证，导致语法校验失败。

下面给出几种解决方案，按推荐程度排序：

方案一：直接使用JPA自带的save方法（强烈推荐） #

JpaRepository已经继承了CrudRepository，自带的save方法完全可以满足单条实体插入的需求，不需要自己手写插入语句，既简洁又符合Spring Data JPA的设计规范：

// 调用方代码示例
val deviceEntity = ThirdPartyDevicesEntity(
    userId = "user_123",
    deviceManufacturer = "Apple",
    externalUserId = "ext_456",
    accessToken = "token_abc",
    refreshToken = "refresh_xyz",
    tokenExpire = 3600
    // tokenUpdated、createdAt有默认值，updatedAt允许为null，都可以不用手动传参
)
thirdPartyDevicesRepository.save(deviceEntity)

方案二：自定义原生SQL插入（特殊场景使用） #

如果你确实需要自定义插入逻辑（比如批量插入或特殊字段处理），可以使用原生SQL，注意要指定nativeQuery = true，并添加@Modifying注解：

@Repository
@Transactional
interface ThirdPartyDevicesRepository : JpaRepository<ThirdPartyDevicesEntity, String> {
    // 省略其他方法...

    @Modifying
    @Query(
        value = """
            insert into third_party_devices (user_id, device_manufacturer, external_user_id, access_token, refresh_token, token_expire, token_updated, created_at, updated_at) 
            values (:userId, :deviceManufacturer, :externalUserId, :accessToken, :refreshToken, :tokenExpire, :tokenUpdated, :createdAt, :updatedAt)
        """,
        nativeQuery = true
    )
    fun insertThirdPartyDevice(
        @Param("userId") userId: String,
        @Param("deviceManufacturer") deviceManufacturer: String,
        @Param("externalUserId") externalUserId: String,
        @Param("accessToken") accessToken: String,
        @Param("refreshToken") refreshToken: String,
        @Param("tokenExpire") tokenExpire: Int,
        @Param("tokenUpdated") tokenUpdated: LocalDateTime,
        @Param("createdAt") createdAt: LocalDateTime,
        @Param("updatedAt") updatedAt: LocalDateTime?
    )
}

注意：原生SQL要使用数据库表的实际列名（比如user_id，而非实体类的userId），因为你的实体类字段和表列名是驼峰转下划线的映射关系。

额外优化建议 #

1. 简化查询方法：你的findDevicebyUserId方法可以不用手写HQL，通过JPA方法名推导即可实现，更简洁不易出错：

   fun findByUserId(userId: String): ThirdPartyDevicesEntity?
   

2. 优化实体类构造函数：Kotlin的data class可以通过@NoArgsConstructor注解自动生成无参构造函数（需要引入kotlin-jpa插件），不用手动编写私有无参构造：

   @Entity
   @Table(name = "third_party_devices")
   @Data
   @NoArgsConstructor
   class ThirdPartyDevicesEntity(
       @Id val userId: String,
       val deviceManufacturer: String,
       val externalUserId: String,
       val accessToken: String,
       val refreshToken: String,
       val tokenExpire: Int,
       val tokenUpdated: LocalDateTime = LocalDateTime.now(),
       val createdAt: LocalDateTime = LocalDateTime.now(),
       @Column(nullable = true) val updatedAt: LocalDateTime? = null
   )
   

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