Swagger3主页访问地址

该文章已生成可运行项目,

一、Swagger3主页访问地址

1.1、/swagger-ui/index.html

1.1.1、url

http://localhost:8010/swagger-ui/index.html

1.1.2、效果

1.2、doc.html

1.2.1、url

http://localhost:8010/doc.html

1.2.2、效果

本文章已经生成可运行项目
### Swagger 3 默认访问路径 Swagger UI 的默认访问路径通常为 `http://localhost:端口/swagger-ui/` 或者更具体的 `http://localhost:端口/swagger-ui/index.html`[^1]。然而,当集成 Spring Security 后,默认路径可能会受到安全策略的影响而被拦截,从而导致 404 错误。 如果遇到这种情况,可以通过调整 WebMvc 配置以及 Spring Security 配置来解决此问题。例如,在 Spring Security 中允许特定路径免受认证保护: ```java @Configuration public class SecurityConfig extends WebSecurityConfigurerAdapter { @Override protected void configure(HttpSecurity http) throws Exception { http.authorizeRequests() .antMatchers("/swagger-ui/**", "/v3/api-docs/**").permitAll() // 放行 swagger 路径 .anyRequest().authenticated(); } } ``` 此外,还可以通过自定义 Swagger访问路径实现灵活性。例如,可以将默认的 `/swagger-ui/` 更改为其他路径[^2]: ```yaml springfox: documentation: swaggerUiUrl: /custom-swagger-ui/ ``` 或者在 Java 配置类中设置: ```java @Bean public Docket apiDocket() { return new Docket(DocumentationType.OAS_30) .select() .apis(RequestHandlerSelectors.basePackage("com.example.controller")) .paths(PathSelectors.any()) .build(); } @Override protected void addResourceHandlers(ResourceHandlerRegistry registry) { registry.addResourceHandler("/custom-swagger-ui/**") .addResourceLocations("classpath:/META-INF/resources/custom-swagger-ui/"); } ``` 对于无法加载 `swagger.json` 文件的情况,可能是因为资源未正确映射到指定路径。确保以下配置已启用并正确指向 JSON 文件位置[^3]: ```java @Bean public GroupedOpenApi publicApi() { return GroupedOpenApi.builder() .group("springshop-public") .packagesToScan("com.example.controller") // 替换为目标包名 .build(); } ``` 最后,确认项目的静态资源配置是否支持 Swagger 所需的前端文件加载。Spring Boot 自动引入了这些文件,但如果进行了额外的安全或过滤器配置,则可能导致路径不可达。 --- ### 总结 Swagger 3 的默认访问路径通常是 `http://localhost:端口/swagger-ui/` 或 `http://localhost:端口/swagger-ui/index.html`。但在实际开发过程中,由于框架间交互(如 Spring Security),需要特别注意放行相关路径以避免权限错误引发的 404 报错。 --- ####
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值