能否在单个OpenAPI文件中定义含不同API的多服务器？

我希望在一个OpenAPI文件中定义多个服务器，每个服务器对应完全不同的API，示例如下：

# 不符合规范的示例写法
servers:
  - url: http://server1
paths:
  /abc:
    # server1对应的API定义

servers:
  - url: http://server2
paths:
  /completely_different_api:
    # server2对应的API定义（包含不同的媒体类型）

目标是选择服务器后自动切换对应的API，请问这是否可行？目前没找到相关解决方案，有没有可实现该需求的OpenAPI替代工具？

首先明确：OpenAPI规范本身不支持给不同服务器绑定专属的API路径集合。

OpenAPI的顶层servers是全局配置，所有paths下的接口都会关联到每一个服务器，没法单独为某个服务器指定专属的API路径。你给出的示例写法本身就不符合OpenAPI规范——单个OpenAPI文件中不能重复出现servers、paths这类顶层字段，解析器会直接报错。

可行的解决方式： #

• 拆分独立OpenAPI文件：把server1和server2对应的API分别写成两个独立的OpenAPI文档，各自定义自己的servers和paths。如果需要统一管理，可以通过OpenAPI的$ref引用或者组合文档功能关联，但本质上还是两个独立的规范文件。
• 借助工具扩展实现：部分API工具支持自定义逻辑来实现类似效果，比如Postman可以通过环境变量切换服务器，同时配合集合的条件加载规则来切换对应的API请求；一些API网关工具（如Kong、Apigee）也能通过路由配置把不同服务器映射到不同API，但这属于工具层面的扩展，不是OpenAPI规范本身的能力。
• 考虑替代规范：如果坚持要在单个文档中实现服务器与路径的绑定，可以了解下AsyncAPI（虽主打异步API，但部分场景可适配），不过更推荐的还是拆分OpenAPI文件，这是最符合规范且易维护的方案。

内容的提问来源于stack exchange，提问作者Jake