Quarkus v3.4.1+OpenApi v3.0.3如何用$ref复用查询参数模型？

环境 #

• Quarkus v3.4.1
• OpenApi v3.0.3

需求 #

希望通过$ref复用一个查询参数模型。

当前实现 #

"paths" : {
  "/s3/upload" : {
    "get" : {
      "parameters" : [ {
        "name" : "ids",
        "in" : "query",
        "schema" : {
          "type" : "array",
          "items" : {
            "type" : "string"
          }
        }
      } ],
      "responses" : ...
      }
    },

期望实现 #

"paths" : {
  "/s3/upload" : {
    "get" : {
      "$ref" : "#/components/schemas/ParameterListValueObject",
      "responses" : ...
      }
    },

遇到的问题 #

尝试了多种注解写法，但都无法达到预期效果。

内容的提问来源于stack exchange，提问作者Krizsán Balazs