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