在 swagger 编辑器中将路径项目对象中引用参数对象标记为无效

作者: k-risc创建于 2026年2月23日更新于 2026年2月23日

由于 #162, 现在引用了常见的分页参数。它们的定义位于 x-swagger-bake/components/parameters 中。在验证包含这些引用的 Swagger 文件时,Swagger 编辑器会报错:“OAS3 参数 $Ref 应指向参数对象”Image 如果我手动将参数定义移动或复制到 components/parameters 中,并将 $ref 路径更改为新位置,编辑器就不会再报错:Image 我也可以将 components/parameters 中的新定义定义为一个引用,并指向 x-swagger-bake/components/parameters 中的具体定义。这也能通过验证。根据 OpenAPI 规范,对于此类参数的引用应在 components/parameters 中定义:Image 因此,x-swagger-bake/components/parameters 中的定义(以及直接从路径项引用这些定义)是否在任何情况下都有效?

内容来源: swagger-api/swagger-editor