如何在原生JPA查询中使用对象作为过滤参数？

问题背景 #

我有一个包含4个可选过滤参数的原生JPA查询，为提升可读性尝试用对象替代参数，过程中遇到两个问题：

• 创建普通POJO作为过滤器时，出现错误：org.springframework.orm.jpa.JpaSystemException: A problem occurred in the SQL executor : No JDBC mapping could be inferred for parameter - org.hibernate.sql.exec.internal.JdbcParameterImpl@6c173735
• 继承org.hibernate.type.QueryParameterJavaObjectType解决映射问题后，集成Swagger-UI时，原本仅4个字段的对象被渲染出大量父类字段，且无法通过@JsonIgnore隐藏这些第三方类的字段。

补充相关查询代码后，发现示例多仅含过滤器对象参数，而我同时有过滤器和额外参数。虽已临时解决Swagger显示问题，但想了解：是否应放弃使用对象参数、创建API与JPA分离的过滤器对象，或有更简单的JavaType可替代继承QueryParameterJavaObjectType？

解决方案建议 #

1. 优先选择API与JPA分离的过滤器对象 #

这是最稳妥且易维护的方案：

• 为API层创建独立的过滤器DTO，仅保留前端需要的4个字段，用@JsonIgnoreProperties或@JsonProperty精准控制Swagger的字段显示
• 在业务层将API DTO转换为JPA查询用的参数对象（或直接拆解字段传入查询），彻底隔离API与持久层的耦合
• 从根源避免继承Hibernate第三方类，既解决Swagger冗余字段问题，又让代码结构更清晰

2. 替代QueryParameterJavaObjectType的更优方案 #

如果不想拆分对象，有更简单的方式规避映射和Swagger问题：

• 不要让过滤器POJO继承Hibernate类，而是在原生查询中手动拆解过滤器对象的字段作为独立参数
  比如把WHERE name = :filter.name AND age = :filter.age改成WHERE name = :name AND age = :age，调用查询时从过滤器对象中取出对应字段逐个传入
• 这种方式无需自定义类型映射，直接规避JDBC映射错误，同时Swagger只会显示POJO自身的4个字段，不用处理父类冗余

3. 不建议放弃对象参数 #

用对象封装参数的可读性优势很明显，只要处理好分层和映射问题，比零散传参更易维护，尤其后续参数数量增加时，这种优势会更突出

内容的提问来源于stack exchange，提问作者András Ballai