Whitelabel Error Page -- 分析

异常:

This application has no explicit mapping for /error, so you are seeing this as a fallback.

出现这个异常说明了跳转页面的url无对应的值.

在这里插入图片描述
可能产生的原因:

1.Application启动类的位置不对。要将Application类放在最外侧,即包含所有子包 。

原因: spring-boot会自动加载启动类所在包下及其子包下的所有组件。

2.在springboot的配置文件:application.yml或application.properties中关于视图解析器的配置问题:

当pom文件下的spring-boot-starter-paren版本高时使用:
spring.mvc.view.prefix/spring.mvc.view.suffix

当pom文件下的spring-boot-starter-paren版本低时使用:
spring.view.prefix/spring.view.suffix

3.控制器的URL路径书写问题
@RequestMapping(“xxxxxxxxxxxxxx”)
实际访问的路径与”xxx”不符合。

实例1:

在这里插入图片描述
实际路径应该是:http://localhost:8080/hello

但是访问路径:http://localhost:8080

所以当然就失败了,因为访问路径不对。

实例2:

在这里插入图片描述
IDEA目录结构的问题,Application启动类的位置不对。

要将Application类放在最外侧,即包含所有子包 。而我的controller则放在了最外层的包里面,导致找不到页面。

更正方法1:移动控制层的包

把controller类移动进去,再次刷新,即可成功打开页面。

更正方法2:添加@SpringBootApplication(scanBasePackages=“controller”)

package com.hh.demo01;
 
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
 
@SpringBootApplication(scanBasePackages="controller")
public class Demo01Application {
 
	public static void main(String[] args) {
		SpringApplication.run(Demo01Application.class, args);
	}

### 解决 Spring Boot Swagger UI 显示 Whitelabel Error Page 的方法 当遇到 `http://localhost:8080/swagger-ui.html` 返回 Whitelabel 错误页面而 `/v2/api-docs` 正常工作的情况时,这通常意味着 Swagger UI 资源未被正确加载或配置存在问题。 #### 依赖项检查 确保项目的 Maven 或 Gradle 文件中包含了必要的 Swagger 依赖: ```xml <dependency> <groupId>io.springfox</groupId> <artifactId>springfox-swagger2</artifactId> <version>${swagger.version}</version> </dependency> <dependency> <groupId>io.springfox</groupId> <artifactId>springfox-swagger-ui</artifactId> <version>${swagger.version}</version> </dependency> ``` 版本号应保持一致以避免兼容性问题[^4]。 #### 配置类设置 创建并配置一个用于启用 Swagger 功能的 Java 类。该类需标注有 `@Configuration`, `@EnableSwagger2` 注解,并定义 Docket Bean 来指定 API 文档细节: ```java @Configuration @EnableSwagger2 public class SwaggerConfig { @Bean public Docket api() { return new Docket(DocumentationType.SWAGGER_2) .select() .apis(RequestHandlerSelectors.any()) .paths(PathSelectors.any()) .build(); } } ``` 此段代码会扫描所有控制器并将它们暴露给 Swagger UI[^3]。 #### Web 安全性和路径匹配调整 如果应用程序启用了安全机制或者自定义了 URL 模式,则可能需要适当放宽对 Swagger 访问路径的安全控制以及确保正确的静态资源映射。对于基于 Spring Security 的应用来说,可以在 security config 中添加如下规则来允许匿名访问 Swagger 页面及其关联文件: ```java @Override protected void configure(HttpSecurity http) throws Exception { http.authorizeRequests().antMatchers("/swagger-ui/**", "/v2/api-docs").permitAll(); // ... other configurations ... } ``` 另外,确认是否存在任何拦截器阻止了对这些端点的请求;如有必要,在 `WebMvcConfigurer` 实现类里的 `addResourceHandlers()` 方法中注册额外的资源处理器以便更好地支持 Swagger UI 加载所需的 HTML/CSS/JS 文件[^5]。 通过上述措施可以有效解决大多数情况下由于配置不当引起的无法正常展示 Swagger 用户界面的问题。
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值