swagger2的默认访问路径

Swagger2 是一个用于构建、测试和文档化 RESTful API 的框架。Swagger2 默认的访问路径是 http://localhost:端口号/项目名/swagger-ui.html，其中端口号是你项目启动时所使用的端口号，项目名则是你项目的上下文路径。在这个页面中，你可以浏览你的 API 文档、测试接口以及生成客户端 SDK 等。当然，Swagger2 也支持自定义访问路径。

相关问题

swagger没有context-path访问路径

### 解决Swagger在未设置 `context-path` 时的访问路径问题

当Spring Boot应用未显式配置 `server.servlet.context-path` 属性时，默认情况下，应用程序将在根上下文中运行。这意味着所有API端点以及Swagger UI都将直接位于服务器主机名和端口下。

对于Swagger的具体配置，在迁移到最新版（如3.0及以上），推荐采用新的注解方式来启用并自定义API文档功能：

- 使用 `@EnableOpenApi` 替代旧版本中的 `@EnableSwagger2WebMvc` 或其他相似形式[^3]。

为了确保Swagger能够正常工作而不受上下文路径影响，可以按照如下方法调整配置类：

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import springfox.documentation.builders.PathSelectors;
import springfox.documentation.builders.RequestHandlerSelectors;
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.spring.web.plugins.Docket;

@Configuration
@EnableOpenApi
public class SwaggerConfig {

    @Bean
    public Docket api() {
        return new Docket(DocumentationType.OAS_30)
                .select()
                .apis(RequestHandlerSelectors.basePackage("com.example.controller"))
                .paths(PathSelectors.any())
                .build();
    }
}

此段代码创建了一个名为`api()` 的Docket Bean实例，并指定了要扫描的目标包位置用于生成API文档。通过这种方式，即使没有指定 `context-path` ，也可以保证Swagger界面及其关联资源被正确加载。

如果仍然遇到无法访问Swagger的情况，则可能是因为默认静态资源映射冲突或其他原因引起的问题。此时可以通过修改application.properties文件中关于静态资源的位置设定来进行排查：

spring.mvc.static-path-pattern=/static/**
spring.resources.chain.strategy.content.enabled=true
spring.resources.chain.cache=false

这些属性可以帮助排除由于静态资源管理不当而导致的潜在问题。

swagger默认地址

Swagger是一种用于构建、测试和文档化RESTful API的开源工具。它提供了一个互动式的界面，以展示API的可用端点、参数、响应和错误信息。Swagger默认地址是API文档的访问路径，可以通过浏览器打开该地址来查看和测试API。

在使用Swagger时，默认地址通常是"localhost:port/swagger-ui.html"或"localhost:port/swagger-ui/index.html"。其中，"localhost"代表本地主机，"port"代表应用程序的端口号。

要访问Swagger默认地址，首先需要确保已经安装和配置了Swagger。然后，在启动应用程序时，可以在浏览器中键入默认地址并按下回车键，以打开Swagger界面。

在Swagger界面上，可以看到API的所有可用端点和相关信息，包括请求和响应的数据结构、参数的要求和示例、成功和失败的响应状态码以及文档注释等。通过Swagger界面，可以方便地测试API的各种请求和查看其相应的结果。

总之，Swagger默认地址是访问API文档和测试API的入口路径，通过它可以有效地展示和管理API的各种信息，提供了便捷的开发和测试环境。