Quarkus Panache Reactive映射PostgreSQL视图@Convert转换器不生效

你遇到的@Convert转换器不处理查询参数的问题，和实体映射的是数据表还是视图没有关联。Hibernate的AttributeConverter默认行为逻辑如下：

• 从数据库读取结果集映射到实体属性时，自动调用convertToEntityAttribute做值转换
• 实体属性持久化写入数据库时，自动调用convertToDatabaseColumn做值转换
• 绑定查询参数时，默认不会自动调用关联的转换器处理入参，尤其当被@Convert注解标记的字段同时是@Id主键字段时，多个Hibernate Reactive版本都存在主键字段参数绑定跳过转换器的已知兼容问题，这才是你传入明文查不到结果的核心原因。

• 方案1：Repository层手动调用转换器处理入参（最稳定、无版本兼容问题的方案）
  直接在查询方法内注入你自定义的转换器实例，先把明文参数转成数据库存储的密文格式，再传入查询，代码示例如下：

  @ApplicationScoped
  class BalanceRepository: PanacheRepository<Balance> {
      // 注入自定义加密转换器
      @Inject
      lateinit var encryptionConverter: EncryptionConverter
  
      fun findByEncryptedCol(col: String): Balance {
          // 手动执行明文到密文的转换
          val encryptedQueryParam = encryptionConverter.convertToDatabaseColumn(col)
          return find("encryptedCol", encryptedQueryParam).singleResult()
      }
  }
  

• 方案2：开启转换器自动应用（仅适合非主键字段场景）
  在你的EncryptionConverter类的@Converter注解上添加autoApply = true属性，配置后Hibernate会对所有匹配类型的字段、查询参数自动应用该转换器。注意：该方式对标记了@Id的主键字段无效，主键字段的参数绑定仍需手动处理。

  // 转换器配置示例
  @Converter(autoApply = true)
  class EncryptionConverter implements AttributeConverter<String, String> {
      // 你的加解密实现逻辑
  }
  

• 方案3：调整实体主键设计（长期规范方案）
  不建议将需要做值转换的加密字段设为实体主键，你可以给Balance实体新增一个无业务含义的自增/序列生成主键，把加密字段设为普通业务字段，配合autoApply配置即可实现查询参数自动转换，同时也能规避主键字段带来的各类Hibernate兼容问题。

注意：不要为了解决这个问题修改数据库视图定义，视图本身的读写逻辑和物理表对Hibernate是完全透明的，不存在视图不支持转换器的限制。

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