springboot swagger 配置Servers

Spring Boot Swagger（现在更常用的是Springfox）是一个用于文档生成的强大工具，它允许你在Spring应用程序中轻松地添加API文档。配置Servers主要是为了指定API的上下文路径以及基础URL，以便生成的文档能够准确反映应用的实际部署位置。

在Swagger的配置中，你可以通过`@EnableSwagger2`注解启用Swagger，并在`application.yml`或`application.properties`文件中设置相关的服务器信息。以下是基本的配置步骤：

1. 添加依赖：在你的pom.xml或build.gradle文件中加入Springfox的依赖。

<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger2</artifactId>
    <version>3.x.x</version> <!-- 使用最新的版本 -->
</dependency>
<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger-ui</artifactId>
    <version>3.x.x</version>
</dependency>

2. 配置application.yml（YAML格式）:

swagger:
  servers:
    - url: http://localhost:8080/api-docs   # 本地开发环境
      description: "本地开发服务器"
    - url: https://your-api.example.com/docs  # 生产环境
      description: "生产环境API地址"

或者application.properties (properties格式):

swagger.servers.url=http://localhost:8080/api-docs
swagger.servers.url=https://your-api.example.com/docs
swagger.servers.description=生产环境API地址

在这里，`url`字段指定了API的基础URL，`description`则是描述性的名称，有助于用户理解每个服务器的作用。