You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Springdoc OpenAPI v2是否支持为QueryDSL谓词路径生成查询参数文档?

Spring Data REST + QueryDSL + Springdoc v2集成的OpenAPI查询参数文档生成问题

Spring Data REST可简化CRUD REST控制器的模板创建。与QueryDSL集成后,HTTP查询参数可绑定到QueryDSL路径以过滤集合资源,例如:
GET /items?myProperty=foo
甚至支持关联属性的嵌套过滤:
GET /items?myRelation.myProperty=foo

只要仓库继承QuerydslPredicateExecutor和QuerydslBinderCustomizer,并使用@RepositoryRestResource注解,就能开箱即用上述过滤功能,无需手动定义端点方法或查询参数。

但在集成Springdoc v2生成OpenAPI规范时,无法自动为所有可能的属性路径生成对应的查询参数文档。

这种情况其实符合预期,理论上可通过反射检查生成的EntityPath实现类或实体类字段来实现该功能,但旧讨论显示该功能曾在OpenAPI v1 + Spring Boot v2的组合中可用:

  • 2023年的类似问题,未找到适配Springdoc v2的解决方案
  • 2022年的类似问题,存在适用于Springdoc v1的可行方案

目前三者集成的相关文档和讨论较少,想请教:

  1. 该功能是否仍可通过配置实现?
  2. 是否有可用的演示示例或相关文档参考?

内容的提问来源于stack exchange,提问作者Ben

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.06.13 05:53:10