是否可以从另一个 OpenAPI 文件引用服务器对象

Question

我正在使用OpenAPI 3.0记录API列表，并为每个API记录一个单独的YAML文件。

所有 API 都使用相同的目标服务器，因此目前每个 API 定义中都有以下内容：

...
servers:
  - url: www.abc.com   
    description: "Production Server" 

但我不想在所有 API 定义中重复servers。相反，我想从单个文件中引用servers，如下所示：

# sample.yaml
...
servers:
  $ref: 'index.yaml#/servers'

但 Swagger UI 显示"无法呈现此组件"错误。

是否可以在 OpenAPI 3.0 定义中$ref servers？

Answer 1

OpenAPI 3.0 和 3.1 规范不支持 servers 中的$ref。

下面是一个现有的功能请求：
https://github.com/OAI/OpenAPI-Specification/issues/2338