springboot配置404、403、500等错误页面自动跳转

本文介绍如何在SpringBoot 1.x及2.x中配置不同状态码对应的错误页面,包括使用EmbeddedServletContainerCustomizer和ErrorViewResolver等方法。

记录

springboot 1.x可使用(springboot2.x以上版本EmbeddedServletContainerCustomizer已被替代):

import org.springframework.boot.context.embedded.ConfigurableEmbeddedServletContainer;
import org.springframework.boot.context.embedded.EmbeddedServletContainerCustomizer;
import org.springframework.boot.web.servlet.ErrorPage;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.http.HttpStatus;
 
@Configuration
public class ErrorPageConfig  {
    @Bean
    public EmbeddedServletContainerCustomizer containerCustomizer() {
        return new EmbeddedServletContainerCustomizer() {
            public void customize(ConfigurableEmbeddedServletContainer container) {
                ErrorPage error400Page = new ErrorPage(HttpStatus.BAD_REQUEST, "/error/400.htm");
                ErrorPage error401Page = new ErrorPage(HttpStatus.UNAUTHORIZED, "/error/401.htm");
                ErrorPage error404Page = new ErrorPage(HttpStatus.NOT_FOUND, "/error/404.htm");
                ErrorPage error500Page = new ErrorPage(HttpStatus.INTERNAL_SERVER_ERROR, "/error/500.htm");
 
                container.addErrorPages(error400Page, error401Page, error404Page, error500Page);
            }
        };
    }
}

或者:

@ServletComponentScan
@SpringBootApplication
public class Application extends SpringBootServletInitializer implements EmbeddedServletContainerCustomizer{

	public static void main(String[] args) {
		SpringApplication.run(Application.class, args);
	}
	
	@Override
	public void customize(ConfigurableEmbeddedServletContainer container) {
		container.addErrorPages(new ErrorPage(HttpStatus.BAD_REQUEST, "/error/400"));            
		container.addErrorPages(new ErrorPage(HttpStatus.INTERNAL_SERVER_ERROR, "/error/500"));            
		container.addErrorPages(new ErrorPage(HttpStatus.NOT_FOUND, "/error/404"));     
	}
}

springboot 2.x可使用:

import java.util.Map;

import javax.servlet.http.HttpServletRequest;

import org.springframework.boot.autoconfigure.web.servlet.error.ErrorViewResolver;
import org.springframework.http.HttpStatus;
import org.springframework.stereotype.Component;
import org.springframework.web.servlet.ModelAndView;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;


@Component
public class OpenApiErrorViewResolver implements ErrorViewResolver {
	
	private static Logger log = LoggerFactory.getLogger(OpenApiErrorViewResolver.class);
	
    @Override
    public ModelAndView resolveErrorView(HttpServletRequest request, HttpStatus status, Map<String, Object> model) {
    	log.info("进入异常跳转");
        if("404".equals(String.valueOf(status))){
        	log.info("404异常跳转");
            return new ModelAndView("/error/404");
        }else if("403".equals(String.valueOf(status))){
        	log.info("403异常跳转");
            return new ModelAndView("/error/unauth");
        }else if("500".equals(String.valueOf(status))){
        	log.info("500异常跳转");
            return new ModelAndView("/error/500");
        }else{
        	log.info("默认异常跳转");
            return new ModelAndView("/error/404");
        }
    }
}

或者:

import javax.servlet.http.HttpServletRequest;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.boot.web.servlet.error.ErrorController;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;

@Controller
public class MyException implements ErrorController {
 
	private static Logger log = LoggerFactory.getLogger(MyException.class);
 
    @RequestMapping("/error")
    public String handleError(HttpServletRequest request) {
    	log.info("进入异常跳转");
        Integer statusCode = (Integer) request.getAttribute("javax.servlet.error.status_code");
        switch (statusCode) {
            case 404:
            	log.info("404异常跳转");
                return "/error/404";
            case 403:
            	log.info("403异常跳转");
                return "/error/unauth";
            case 500:
            	log.info("500异常跳转");
                return "/error/500";
            default:
            	log.info("默认异常跳转");
                return "/error/404";
        }
 
    }
    
    @Override
    public String getErrorPath() {
        return "/error";
    }
}

 

### 解决 Spring Boot 中 JSP 页面 404 错误 在处理 Spring Boot 应用程序中的 JSP 页面返回 `404 Not Found` 的问题时,有几个关键点需要注意。首先确认应用程序配置正确无误。 #### 配置应用属性文件 对于不同版本的 Spring Boot,在 `application.properties` 文件中设置不同的参数来启用开发模式下的自动重新加载功能[^2]: - **Spring Boot 1.5 版本** ```properties server.jsp-servlet.init-parameters.development=true ``` - **Spring Boot 2.x 版本及以上** ```properties server.servlet.jsp.init-parameters.development=true ``` 这些配置允许开发者在修改 JSP 文件后无需重启整个服务器即可查看更改效果。 #### 正确放置视图资源 确保所有的 JSP 文件都存放在合适的位置以便被正确识别。默认情况下,JSP 文件应该位于 `src/main/webapp/WEB-INF/jsp/` 路径下[^3]。例如: ``` src/ └── main/ ├── java/ └── webapp/ └── WEB-INF/ └── jsp/ └── helloWorld.jsp ``` #### 修改控制器映射路径 为了使 URL 映射能够成功指向相应的 JSP 页面,需要调整 Controller 类里的方法签名以及返回值字符串。假设有一个名为 `helloWorld.jsp` 的页面,则对应的 controller 方法可能如下所示: ```java import org.springframework.stereotype.Controller; import org.springframework.web.bind.annotation.GetMapping; @Controller public class HelloWorldController { @GetMapping("/helloworld") public String showPage() { return "jsp/helloWorld"; // 对应于 /WEB-INF/jsp/helloWorld.jsp } } ``` 注意这里并没有加上 `.jsp` 后缀名,因为这是由框架内部解析完成的工作。 #### 使用内嵌 Tomcat 支持 JSP 渲染 由于某些原因,默认打包方式可能会导致无法正常渲染 JSP 页面。可以通过指定构建工具插件的方式强制使用内置的 Tomcat 容器并开启对 JSP 的支持。以 Maven 构建为例,可以在 pom.xml 添加以下依赖项[^4]: ```xml <dependency> <groupId>org.apache.tomcat.embed</groupId> <artifactId>tomcat-embed-jasper</artifactId> <scope>provided</scope> </dependency> <!-- 如果还需要额外的支持 --> <dependency> <groupId>javax.servlet</groupId> <artifactId>jstl</artifactId> </dependency> ``` 通过以上措施,应当能有效解决大多数关于 Spring Boot 下 JSP 页面显示为空白页或提示找不到的问题。
评论 3
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值