springboot + shiro 權限注解、統一異常處理、請求亂碼解決

前篇

后臺權限管理系統

20200808新版本更新

版本升級及內容優化版本，改動內容：

版本更新，springboot從1.5+升級到2.1+；

權限緩存使用redis；

驗證碼使用redis；

權限驗證完善。

相關：

基于前篇，新增功能：

新增shiro權限注解；

請求亂碼問題解決；

統一異常處理。

源碼已集成到項目中：

shiro注解的使用

shiro權限注解

Shiro 提供了相應的注解用于權限控制，如果使用這些注解就需要使用AOP 的功能來進行判斷，如Spring AOP；Shiro 提供了Spring AOP 集成用于權限注解的解析和驗證。

@RequiresAuthentication

表示當前Subject已經通過login 進行了身份驗證；即Subject.isAuthenticated()返回true。

@RequiresUser

表示當前Subject已經身份驗證或者通過記住我登錄的。

@RequiresGuest

表示當前Subject沒有身份驗證或通過記住我登錄過，即是游客身份。

@RequiresRoles(value={“admin”, “user”}, logical= Logical.AND)

@RequiresRoles(value={“admin”})

@RequiresRoles({“admin“})

表示當前Subject需要角色admin 和user。

@RequiresPermissions (value={“user:a”, “user:b”}, logical= Logical.OR)

表示當前Subject需要權限user:a或user:b。

Shiro的認證注解處理是有內定的處理順序的，如果有多個注解的話，前面的通過了會繼續檢查后面的，若不通過則直接返回，處理順序依次為(與實際聲明順序無關)：

RequiresRoles

RequiresPermissions

RequiresAuthentication

RequiresUser

RequiresGuest

以上注解既可以用在controller中，也可以用在service中使用；

建議將shiro注解放在controller中，因為如果service層使用了spring的事物注解，那么shiro注解將無效。

shiro權限注解springAOP配置

shiro權限注解要生效，必須配置springAOP通過設置shiro的SecurityManager進行權限驗證。

/**

*

* @描述：開啟Shiro的注解(如@RequiresRoles,@RequiresPermissions),需借助SpringAOP掃描使用Shiro注解的類,并在必要時進行安全邏輯驗證

* 配置以下兩個bean(DefaultAdvisorAutoProxyCreator和AuthorizationAttributeSourceAdvisor)即可實現此功能

* Enable Shiro Annotations for Spring-configured beans. Only run after the lifecycleBeanProcessor(保證實現了Shiro內部lifecycle函數的bean執行) has run

* 不使用注解的話，可以注釋掉這兩個配置

* @創建人：wyait

* @創建時間：2018年5月21日 下午6:07:56

* @return

*/

@Bean

public DefaultAdvisorAutoProxyCreator advisorAutoProxyCreator() {

DefaultAdvisorAutoProxyCreator advisorAutoProxyCreator = new DefaultAdvisorAutoProxyCreator();

advisorAutoProxyCreator.setProxyTargetClass(true);

return advisorAutoProxyCreator;

}

@Bean

public AuthorizationAttributeSourceAdvisor authorizationAttributeSourceAdvisor() {

AuthorizationAttributeSourceAdvisor authorizationAttributeSourceAdvisor = new AuthorizationAttributeSourceAdvisor();

authorizationAttributeSourceAdvisor.setSecurityManager(securityManager());

return authorizationAttributeSourceAdvisor;

}

springboot異常處理原理

場景：當用戶正常訪問網站時，因為某種原因后端出現exception的時候，直接暴露異常信息或頁面顯示給用戶；

這種操作體驗不是我們想要的。所以要對異常進行統一管理，能提高用戶體驗的同時，后臺能詳細定位到異常的問題點。

springboot異常概況

Spring Boot提供了默認的統一錯誤頁面，這是Spring MVC沒有提供的。在理解了Spring Boot提供的錯誤處理相關內容之后，我們可以方便的定義自己的錯誤返回的格式和內容。

編寫by zero異常

在home頁面，手動創建兩個異常：普通異常和異步異常！

前端頁面：

普通請求異常：

點擊

ajax異步請求異常：

點擊

...

//js代碼

function ajaxError(){

$.get("/error/ajaxError",function(data){

layer.alert(data);

});

}

后端代碼：

/**

*

* @描述：普通請求異常

* @創建人：wyait

* @創建時間：2018年5月24日 下午5:30:50

*/

@RequestMapping("getError")

public void toError(){

System.out.println(1/0);

}

/**

*

* @描述：異步異常

* @創建人：wyait

* @創建時間：2018年5月24日 下午5:30:39

*/

@RequestMapping("ajaxError")

@ResponseBody

public String ajaxError(){

System.out.println(1/0);

return "異步請求成功！";

}

異常效果

普通異常：

console錯誤信息：

[2018-05-25 09:30:04.669][http-nio-8077-exec-8][ERROR][org.apache.juli.logging.DirectJDKLog][181]:Servlet.service() for servlet [dispatcherServlet] in context with path [] threw exception [Request processing failed; nested exception is java.lang.ArithmeticException: / by zero] with root cause

java.lang.ArithmeticException: / by zero

at com.wyait.manage.web.error.IndexErrorController.toError(IndexErrorController.java:18) ~[classes/:?]

...

at java.lang.Thread.run(Thread.java:748) [?:1.8.0_131]

...

[2018-05-25 09:30:04.676][http-nio-8077-exec-8][DEBUG][org.springframework.web.servlet.handler.AbstractHandlerMethodMapping][317]:Returning handler method [public org.springframework.web.servlet.ModelAndView org.springframework.boot.autoconfigure.web.BasicErrorController.errorHtml(javax.servlet.http.HttpServletRequest,javax.servlet.http.HttpServletResponse)]

[2018-05-25 09:30:04.676][http-nio-8077-exec-8][DEBUG][org.springframework.web.servlet.handler.AbstractHandlerMethodMapping][317]:Returning handler method [public org.springframework.web.servlet.ModelAndView org.springframework.boot.autoconfigure.web.BasicErrorController.errorHtml(javax.servlet.http.HttpServletRequest,javax.servlet.http.HttpServletResponse)]

[2018-05-25 09:30:04.676][http-nio-8077-exec-8][DEBUG][org.springframework.beans.factory.support.AbstractBeanFactory][251]:Returning cached instance of singleton bean 'basicErrorController'

[2018-05-25 09:30:04.676][http-nio-8077-exec-8][DEBUG][org.springframework.beans.factory.support.AbstractBeanFactory][251]:Returning cached instance of singleton bean 'basicErrorController'

...

[2018-05-25 09:30:04.686][http-nio-8077-exec-8][DEBUG][org.springframework.web.servlet.view.ContentNegotiatingViewResolver][263]:Requested media types are [text/html, text/html;q=0.8] based on Accept header types and producible media types [text/html])

[2018-05-25 09:30:04.686][http-nio-8077-exec-8][DEBUG][org.springframework.web.servlet.view.ContentNegotiatingViewResolver][263]:Requested media types are [text/html, text/html;q=0.8] based on Accept header types and producible media types [text/html])

[2018-05-25 09:30:04.686][http-nio-8077-exec-8][DEBUG][org.springframework.beans.factory.support.AbstractBeanFactory][251]:Returning cached instance of singleton bean 'error'

[2018-05-25 09:30:04.686][http-nio-8077-exec-8][DEBUG][org.springframework.beans.factory.support.AbstractBeanFactory][251]:Returning cached instance of singleton bean 'error'

[2018-05-25 09:30:04.686][http-nio-8077-exec-8][DEBUG][org.springframework.web.servlet.view.ContentNegotiatingViewResolver][338]:Returning [org.springframework.boot.autoconfigure.web.ErrorMvcAutoConfiguration$SpelView@6ffd99fb] based on requested media type 'text/html'

[2018-05-25 09:30:04.686][http-nio-8077-exec-8][DEBUG][org.springframework.web.servlet.view.ContentNegotiatingViewResolver][338]:Returning [org.springframework.boot.autoconfigure.web.ErrorMvcAutoConfiguration$SpelView@6ffd99fb] based on requested media type 'text/html'

...

通過日志可知，springboot返回的錯誤頁面，是通過：org.springframework.boot.autoconfigure.web.BasicErrorController.errorHtml處理返回ModelAndView。

異步異常：

console日志信息：

[2018-05-25 09:31:19.958][http-nio-8077-exec-6][ERROR][org.apache.juli.logging.DirectJDKLog][181]:Servlet.service() for servlet [dispatcherServlet] in context with path [] threw exception [Request processing failed; nested exception is java.lang.ArithmeticException: / by zero] with root cause

java.lang.ArithmeticException: / by zero

at com.wyait.manage.web.error.IndexErrorController.ajaxError(IndexErrorController.java:29) ~[classes/:?]

...

at java.lang.Thread.run(Thread.java:748) [?:1.8.0_131]

...

[2018-05-25 09:31:19.960][http-nio-8077-exec-6][DEBUG][org.springframework.web.servlet.handler.AbstractHandlerMethodMapping][317]:Returning handler method [public org.springframework.http.ResponseEntity> org.springframework.boot.autoconfigure.web.BasicErrorController.error(javax.servlet.http.HttpServletRequest)]

[2018-05-25 09:31:19.960][http-nio-8077-exec-6][DEBUG][org.springframework.web.servlet.handler.AbstractHandlerMethodMapping][317]:Returning handler method [public org.springframework.http.ResponseEntity> org.springframework.boot.autoconfigure.web.BasicErrorController.error(javax.servlet.http.HttpServletRequest)]

[2018-05-25 09:31:19.960][http-nio-8077-exec-6][DEBUG][org.springframework.beans.factory.support.AbstractBeanFactory][251]:Returning cached instance of singleton bean 'basicErrorController'

[2018-05-25 09:31:19.960][http-nio-8077-exec-6][DEBUG][org.springframework.beans.factory.support.AbstractBeanFactory][251]:Returning cached instance of singleton bean 'basicErrorController'

...

[2018-05-25 09:31:19.961][http-nio-8077-exec-6][DEBUG][org.springframework.web.servlet.mvc.method.annotation.AbstractMessageConverterMethodProcessor][234]:Written [{timestamp=Fri May 25 09:31:19 CST 2018, status=500, error=Internal Server Error, exception=java.lang.ArithmeticException, message=/ by zero, path=/error/ajaxError}] as "application/json" using [org.springframework.http.converter.json.MappingJackson2HttpMessageConverter@2729eae5]

[2018-05-25 09:31:19.961][http-nio-8077-exec-6][DEBUG][org.springframework.web.servlet.mvc.method.annotation.AbstractMessageConverterMethodProcessor][234]:Written [{timestamp=Fri May 25 09:31:19 CST 2018, status=500, error=Internal Server Error, exception=java.lang.ArithmeticException, message=/ by zero, path=/error/ajaxError}] as "application/json" using [org.springframework.http.converter.json.MappingJackson2HttpMessageConverter@2729eae5]

[2018-05-25 09:31:19.961][http-nio-8077-exec-6][DEBUG][org.springframework.web.servlet.DispatcherServlet][1048]:Null ModelAndView returned to DispatcherServlet with name 'dispatcherServlet': assuming HandlerAdapter completed request handling

...

通過日志可知，springboot返回的錯誤信息，是通過：org.springframework.boot.autoconfigure.web.BasicErrorController.error處理返回ResponseEntity。

異常都是通過org.springframework.boot.autoconfigure.web.BasicErrorController控制處理的。

springboot異常處理解析

查看org.springframework.boot.autoconfigure.web包下面的類，跟蹤springboot對error異常處理機制。自動配置通過一個MVC error控制器處理錯誤

通過spring-boot-autoconfigure引入

查看springboot 處理error的類

springboot的自動配置，在web中處理error相關的自動配置類：ErrorMvcAutoConfiguration。查看與處理error相關的類：

ErrorMvcAutoConfiguration.class

ErrorAttibutes.class

ErrorController.class

ErrorProperties.class

ErrorViewResolver.class

...

ErrorAutoConfiguration類源碼//TODO

ErrorAutoConfiguration注冊的bean

//4個BEAN

@Bean

@ConditionalOnMissingBean(value = ErrorAttributes.class, search = SearchStrategy.CURRENT)

public DefaultErrorAttributes errorAttributes() {

return new DefaultErrorAttributes();

}

@Bean

@ConditionalOnMissingBean(value = ErrorController.class, search = SearchStrategy.CURRENT)

public BasicErrorController basicErrorController(ErrorAttributes errorAttributes) {

return new BasicErrorController(errorAttributes, this.serverProperties.getError(),

this.errorViewResolvers);

}

@Bean

public ErrorPageCustomizer errorPageCustomizer() {

return new ErrorPageCustomizer(this.serverProperties);

}

@Bean

public static PreserveErrorControllerTargetClassPostProcessor preserveErrorControllerTargetClassPostProcessor() {

return new PreserveErrorControllerTargetClassPostProcessor();

}

DefaultErrorAttributes類

@Order(Ordered.HIGHEST_PRECEDENCE)

public class DefaultErrorAttributes

implements ErrorAttributes, HandlerExceptionResolver, Ordered {

...

}

ErrorAttributes：

public interface ErrorAttributes {

Map getErrorAttributes(RequestAttributes requestAttributes,

boolean includeStackTrace);

Throwable getError(RequestAttributes requestAttributes);

}

HandlerExceptionResolver：

public interface HandlerExceptionResolver {

/**

* Try to resolve the given exception that got thrown during handler execution,

* returning a {@link ModelAndView} that represents a specific error page if appropriate.

*/

ModelAndView resolveException(

HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex);

}

DefaultErrorAttributes類：

實現了ErrorAttributes接口，當處理/error錯誤頁面時，可以在該bean中讀取錯誤信息響應返回；

實現了HandlerExceptionResolver接口。

debug跟蹤源碼：即DispatcherServlet在doDispatch過程中有異常拋出時：

一. 先由HandlerExceptionResolver.resolveException解析異常并保存在request中;

二. 再DefaultErrorAttributes.getErrorAttributes處理；DefaultErrorAttributes在處理過程中，從request中獲取錯誤信息，將錯誤信息保存到RequestAttributes中；

三. 最后在獲取錯誤信息getError(RequestAttributes)時，從RequestAttributes中取到錯誤信息。

BasicErrorController類

@Controller

@RequestMapping("${server.error.path:${error.path:/error}}")

public class BasicErrorController extends AbstractErrorController {

private final ErrorProperties errorProperties;

...

@RequestMapping(produces = "text/html")

public ModelAndView errorHtml(HttpServletRequest request,

HttpServletResponse response) {

HttpStatus status = getStatus(request);

Map model = Collections.unmodifiableMap(getErrorAttributes(

request, isIncludeStackTrace(request, MediaType.TEXT_HTML)));

response.setStatus(status.value());

ModelAndView modelAndView = resolveErrorView(request, response, status, model);

return (modelAndView == null ? new ModelAndView("error", model) : modelAndView);

}

@RequestMapping

@ResponseBody

public ResponseEntity> error(HttpServletRequest request) {

Map body = getErrorAttributes(request,

isIncludeStackTrace(request, MediaType.ALL));

HttpStatus status = getStatus(request);

return new ResponseEntity>(body, status);

}

...

}

resolveErrorView方法(查找=error/“錯誤狀態碼”；的資源)：

如果不是異常請求，會執行resolveErrorView方法；該方法會先在默認或配置的靜態資源路徑下查找error/HttpStatus(錯誤狀態碼)的資源文件，如果沒有；使用默認的error頁面。

public class DefaultErrorViewResolver implements ErrorViewResolver, Ordered {

...

@Override

public ModelAndView resolveErrorView(HttpServletRequest request, HttpStatus status,

Map model) {

//status：異常錯誤狀態碼

ModelAndView modelAndView = resolve(String.valueOf(status), model);

if (modelAndView == null && SERIES_VIEWS.containsKey(status.series())) {

modelAndView = resolve(SERIES_VIEWS.get(status.series()), model);

}

return modelAndView;

}

private ModelAndView resolve(String viewName, Map model) {

//視圖名稱，默認是error/+“status”錯誤狀態碼；比如：error/500、error/404

String errorViewName = "error/" + viewName;

TemplateAvailabilityProvider provider = this.templateAvailabilityProviders

.getProvider(errorViewName, this.applicationContext);

if (provider != null) {

return new ModelAndView(errorViewName, model);

}

return resolveResource(errorViewName, model);

}

//在資源文件中查找error/500或error/404等頁面

private ModelAndView resolveResource(String viewName, Map model) {

for (String location : this.resourceProperties.getStaticLocations()) {

try {

Resource resource = this.applicationContext.getResource(location);

resource = resource.createRelative(viewName + ".html");

if (resource.exists()) {

return new ModelAndView(new HtmlResourceView(resource), model);

}

}

catch (Exception ex) {

}

}

return null;

}

...

}

BasicErrorController根據Accept頭的內容，輸出不同格式的錯誤響應。比如針對瀏覽器的請求生成html頁面，針對其它請求生成json格式的返回。

可以通過配置error/HttpStatus頁面實現自定義錯誤頁面。

ErrorPageCustomizer類

/**

* {@link EmbeddedServletContainerCustomizer} that configures the container's error

* pages.

*/

private static class ErrorPageCustomizer implements ErrorPageRegistrar, Ordered {

private final ServerProperties properties;

protected ErrorPageCustomizer(ServerProperties properties) {

this.properties = properties;

}

@Override

public void registerErrorPages(ErrorPageRegistry errorPageRegistry) {

ErrorPage errorPage = new ErrorPage(this.properties.getServletPrefix()

+ this.properties.getError().getPath());

errorPageRegistry.addErrorPages(errorPage);

}

@Override

public int getOrder() {

return 0;

}

}

將錯誤頁面注冊到內嵌的tomcat的servlet容器中。

PreserveErrorControllerTargetClassPostProcessor實現BeanFactoryPostProcessor接口，可以修改BEAN的配置信息

ErrorAutoConfiguration內的兩個配置

//2個config配置

@Configuration

static class DefaultErrorViewResolverConfiguration {

private final ApplicationContext applicationContext;

private final ResourceProperties resourceProperties;

DefaultErrorViewResolverConfiguration(ApplicationContext applicationContext,

ResourceProperties resourceProperties) {

this.applicationContext = applicationContext;

this.resourceProperties = resourceProperties;

}

@Bean

@ConditionalOnBean(DispatcherServlet.class)

@ConditionalOnMissingBean

public DefaultErrorViewResolver conventionErrorViewResolver() {

return new DefaultErrorViewResolver(this.applicationContext,

this.resourceProperties);

}

}

@Configuration

@ConditionalOnProperty(prefix = "server.error.whitelabel", name = "enabled", matchIfMissing = true)

@Conditional(ErrorTemplateMissingCondition.class)

protected static class WhitelabelErrorViewConfiguration {

private final SpelView defaultErrorView = new SpelView(

"

Whitelabel Error Page

"

+ "

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

"

+ "

${timestamp}"

+ "

There was an unexpected error (type=${error}, status=${status})."

+ "

${message}");

@Bean(name = "error")

@ConditionalOnMissingBean(name = "error")

public View defaultErrorView() {

return this.defaultErrorView;

}

// If the user adds @EnableWebMvc then the bean name view resolver from

// WebMvcAutoConfiguration disappears, so add it back in to avoid disappointment.

@Bean

@ConditionalOnMissingBean(BeanNameViewResolver.class)

public BeanNameViewResolver beanNameViewResolver() {

BeanNameViewResolver resolver = new BeanNameViewResolver();

resolver.setOrder(Ordered.LOWEST_PRECEDENCE - 10);

return resolver;

}

}

DefaultErrorViewResolverConfiguration：默認的error視圖解析配置；

WhitelabelErrorViewConfiguration：默認設置了/error的頁面，和Whitelabel Error Page頁面響應內容。

如果Spring MVC在處理業務的過程中拋出異常，會被 Servlet 容器捕捉到，Servlet 容器再將請求轉發給注冊好的異常處理映射 /error 做響應處理。

springboot配置文件默認error相關配置

springboot配置文件application.properties中關于error默認配置：

server.error.include-stacktrace=never # When to include a "stacktrace" attribute.

server.error.path=/error # Path of the error controller.

server.error.whitelabel.enabled=true # Enable the default error page displayed in browsers in case of a server error.

springboot 自定義異常處理

通過跟蹤springboot對異常處理得源碼跟蹤，根據業務需要，可以細分前端響應的錯誤頁面，也可以統一使用/error頁面+錯誤提示信息進行處理。

根據自己的需求自定義異常處理機制；具體可實施的操作如下：

可以通過配置error/HttpStatus(錯誤狀態碼)頁面實現自定義錯誤頁面【底層實現，詳見：BasicErrorController源碼】；

可以實現BasicErrorController，自定義普通請求的異常頁面響應信息和異步請求的響應信息，統一使用/error頁面進行錯誤響應提示；

自定義實現ErrorAttributes接口，覆蓋DefaultErrorAttributes實現，或是繼承DefaultErrorAttributes類，重寫里面的方法【TODO，不推薦】。

1和2的方法可單獨使用，也可以結合使用。

自定義異常頁面

可以根據不同的錯誤狀態碼，在前端細分不同的響應界面給用戶進行提示；資源路徑必須是：靜態資源路徑下/error/HttpStats(比如：/error/404等)

自定義異常頁面

404友情提示

訪問的資源未找到(404)

404.html

500.html等，這里只演示404。

統一異常處理

普通請求，前端使用error頁面+自定義錯誤響應信息；

其他請求(異步)，統一自定義錯誤響應信息，規范處理異步響應的錯誤判斷和處理。

使用springMVC注解ControllerAdvice

/**

*

* @項目名稱：wyait-manage

* @類名稱：GlobalExceptionHandler

* @類描述：統一異常處理，包括【普通調用和ajax調用】

* ControllerAdvice來做controller內部的全局異常處理，但對于未進入controller前的異常，該處理方法是無法進行捕獲處理的，SpringBoot提供了ErrorController的處理類來處理所有的異常(TODO)。

* 1.當普通調用時，跳轉到自定義的錯誤頁面；2.當ajax調用時，可返回約定的json數據對象，方便頁面統一處理。

* @創建人：wyait

* @創建時間：2018年5月22日 上午11:44:55

* @version：

*/

@ControllerAdvice

public class GlobalExceptionHandler {

private static final Logger logger = LoggerFactory

.getLogger(GlobalExceptionHandler.class);

public static final String DEFAULT_ERROR_VIEW = "error";

/**

*

* @描述：針對普通請求和ajax異步請求的異常進行處理

* @創建人：wyait

* @創建時間：2018年5月22日 下午4:48:58

* @param req

* @param e

* @return

* @throws Exception

*/

@ExceptionHandler(value = Exception.class)

@ResponseBody

public ModelAndView errorHandler(HttpServletRequest request,

HttpServletResponse response, Exception e) {

logger.debug(getClass().getName() + ".errorHandler】統一異常處理：request="+request);

ModelAndView mv=new ModelAndView();

logger.info(getClass().getName() + ".errorHandler】統一異常處理："+e.getMessage());

//1 獲取錯誤狀態碼

HttpStatus httpStatus=getStatus(request);

logger.info(getClass().getName() + ".errorHandler】統一異常處理!錯誤狀態碼httpStatus："+httpStatus);

//2 返回錯誤提示

ExceptionEnum ee=getMessage(httpStatus);

//3 將錯誤信息放入mv中

mv.addObject("type", ee.getType());

mv.addObject("code", ee.getCode());

mv.addObject("msg", ee.getMsg());

if(!ShiroFilterUtils.isAjax(request)){

//不是異步請求

mv.setViewName(DEFAULT_ERROR_VIEW);

logger.debug(getClass().getName() + ".errorHandler】統一異常處理：普通請求。");

}

logger.debug(getClass().getName() + ".errorHandler】統一異常處理響應結果：MV="+mv);

return mv;

}

...

}

運行測試：先走GlobalExceptionHandler(使用注解@ControllerAdvice)類里面的方法，而后又執行了BasicErrorController方法；被springboot自帶的BasicErrorController覆蓋。

實現springboot的AbstractErrorController

自定義實現AbstractErrorController，添加響應的錯誤提示信息。

@RequestMapping(produces = "text/html")

public ModelAndView errorHtml(HttpServletRequest request,

HttpServletResponse response) {

ModelAndView mv = new ModelAndView(ERROR_PATH);

/** model對象包含了異常信息 */

Map model = getErrorAttributes(request,

isIncludeStackTrace(request, MediaType.TEXT_HTML));

// 1 獲取錯誤狀態碼(也可以根據異常對象返回對應的錯誤信息)

HttpStatus httpStatus = getStatus(request);

// 2 返回錯誤提示

ExceptionEnum ee = getMessage(httpStatus);

Result result = new Result(

String.valueOf(ee.getType()), ee.getCode(), ee.getMsg());

// 3 將錯誤信息放入mv中

mv.addObject("result", result);

logger.info("統一異常處理【" + getClass().getName()

+ ".errorHtml】統一異常處理!錯誤信息mv：" + mv);

return mv;

}

@RequestMapping

@ResponseBody

//設置響應狀態碼為：200，結合前端約定的規范處理。也可不設置狀態碼，前端ajax調用使用error函數進行控制處理

@ResponseStatus(value=HttpStatus.OK)

public Result error(HttpServletRequest request, Exception e) {

/** model對象包含了異常信息 */

Map model = getErrorAttributes(request,

isIncludeStackTrace(request, MediaType.TEXT_HTML));

// 1 獲取錯誤狀態碼(也可以根據異常對象返回對應的錯誤信息)

HttpStatus httpStatus = getStatus(request);

// 2 返回錯誤提示

ExceptionEnum ee = getMessage(httpStatus);

Result result = new Result(

String.valueOf(ee.getType()), ee.getCode(), ee.getMsg());

// 3 將錯誤信息返回

// ResponseEntity

logger.info("統一異常處理【" + getClass().getName()

+ ".error】統一異常處理!錯誤信息result：" + result);

return result;

}

針對異步請求，統一指定響應狀態碼：200；也可以不指定，前端在處理異步請求的時候，可以通過ajax的error函數進行控制。

這里是繼承的AbstractErrorController類，自定義實現統一異常處理，也可以直接實現ErrorController接口。

前端ajax異步統一處理：

通過約定，前端ajax異步請求，進行統一的錯誤處理。

/**

* 針對不同的錯誤可結合業務自定義處理方式

* @param result

* @returns {Boolean}

*/

function isError(result){

var flag=true;

if(result && result.status){

flag=false;

if(result.status == '-1' || result.status=='-101' || result.status=='400' || result.status=='404' || result.status=='500'){

layer.alert(result.data);

}else if(result.status=='403'){

layer.alert(result.data,function(){

//跳轉到未授權界面

window.location.href="/403";

});

}

}

return flag;//返回true

}

使用方式：

...

success:function(data){

//異常過濾處理

if(isError(data)){

alert(data);

}

},

...

error.html頁面：

出錯了

()

測試效果

普通請求：

異步請求：

線上get請求亂碼

問題描述

前臺通過html頁面，發送請求到后臺查詢數據，在日志中打印的sql語句顯示傳入的參數亂碼：

SELECT ...

[2018-05-11 09:15:00.582][http-bio-8280-exec-2][DEBUG][org.apache.ibatis.logging.jdbc.BaseJdbcLogger][159]:==> Parameters: 1(Integer), ?è′o(String)

[2018-05-11 09:15:00.585][http-bio-8280-exec-2][DEBUG][org.apache.ibatis.logging.jdbc.BaseJdbcLogger][159]:<== Total: 1

...

本地windows開發環境測試沒有亂碼問題；

請求信息

前端頁面發送get請求，瀏覽器默認對get請求路徑進行URL編碼處理。

后臺Controller打印的日志

分頁查詢用戶列表！搜索條件：userSearch：UserSearchDTO{page=1, limit=10, uname='??', umobile='', insertTimeStart='', insertTimeEnd=''},page:1,每頁記錄數量limit:10，請求編碼：UTF-8

Controller層在接收到這個uname參數時，已經是亂碼，ISO-8859-1解碼后的結果。

請求參數編碼流程

前端頁面發送get請求，瀏覽器默認在中文的UTF-8后加上上%得到URL編碼，比如：%e8%b4%b9%e7...；

get請求到tomcat應用服務器后，會以默認的ISO-8859-1進行解碼；

在controller中，接收到的是經過URL編碼和iso-8859-1解碼后的參數值。

具體編碼細節：TODO

解決方案

項目編碼配置【可以不配置】

開發前，默認必須統一編碼環境；正常都是設置為utf-8。

spring boot 與spring mvc不同，在web應用中，spring boot默認的編碼格式為UTF-8，而spring mvc的默認編碼格式為iso-8859-1。

spring boot項目中如果沒有特殊需求，該編碼不需要修改。如果要強制其他編碼格式，spring boot提供了設置方式：

通過application.properties配置文件設置：

# 默認utf-8配置

spring.http.encoding.force=true

spring.http.encoding.charset=UTF-8

spring.http.encoding.enabled=true

server.tomcat.uri-encoding=UTF-8

此時攔截器中返回的中文已經不亂碼了，但是controller中返回的數據可能會依舊亂碼。

參考spring MVC的方式，自定義實現WebMvcConfigurerAdapter類，處理響應數據亂碼問題：

@Bean

public HttpMessageConverter responseBodyConverter() {

StringHttpMessageConverter converter = new StringHttpMessageConverter(Charset.forName("UTF-8"));

return converter;

}

@Override

public void configureMessageConverters(List> converters) {

super.configureMessageConverters(converters);

converters.add(responseBodyConverter());

}

也可以在controller方法@RequestMapping上添加：

produces="text/plain;charset=UTF-8"

這種方法的弊端是限定了數據類型。

亂碼解決方案

表單采用get方式提交，中文亂碼解決方案：

改為post請求；

手動編解碼：

param = new String(param.getBytes("iso8859-1"), "utf-8");

修改tomcat配置server.xml文件：

找到如下代碼：

在這里添加一個屬性：URIEncoding，將該屬性值設置為UTF-8，即可讓Tomcat(默認ISO-8859-1編碼)以UTF-8的編碼處理get請求。

修改完成后：

發送get請求前，瀏覽器中兩次URL編碼：

兩次編碼兩次解碼的過程為：

==UTF-8編碼->UTF-8(iso-8859-1)編碼->iso-8859-1解碼->UTF-8解碼，編碼和解碼的過程是對稱的，所以不會出現亂碼。==

//js代碼

param = encodeURI(param);

// alert("第一次URL編碼：" + param);

param = encodeURI(param);

// alert("第二次URL編碼：" + param);

后臺代碼：

//兩次解碼

URLDecoder.decode(URLDecoder.decode(param,"utf-8"),"utf-8");

總結

以上四種解決方案，可結合具體情況進行使用。

no session異常

異常日志1：

[2018-05-21 18:00:51.574][http-nio-8280-exec-6][DEBUG][org.apache.shiro.web.servlet.SimpleCookie][389]:Found 'SHRIOSESSIONID' cookie value [fc6b7b64-6c59-4f82-853b-e2ca20135b99]

[2018-05-21 18:00:51.575][http-nio-8280-exec-6][DEBUG][org.apache.shiro.mgt.DefaultSecurityManager][447]:Resolved SubjectContext context session is invalid. Ignoring and creating an anonymous (session-less) Subject instance.

org.apache.shiro.session.UnknownSessionException: There is no session with id [fc6b7b64-6c59-4f82-853b-e2ca20135b99]

at org.apache.shiro.session.mgt.eis.AbstractSessionDAO.readSession(AbstractSessionDAO.java:170) ~[shiro-all-1.3.1.jar:1.3.1]

異常日志2【偶爾出現】：

Caused by: javax.crypto.BadPaddingException: Given final block not properly padded

at com.sun.crypto.provider.CipherCore.doFinal(CipherCore.java:811) ~[sunjce_provider.jar:1.7.0_85]

UnknownSessionException

UnknownSessionException: There is no session with id [...]

原因

結合項目配置，分析問題原因：

1，用戶退出后，瀏覽器中的SHIROSESSIONID依然存在；

2，再次發送請求時，攜帶SHIROSESSIONID，會在shiro的DefaultWebSecurityManager.getSessionKey(context)中，逐層跟蹤對應在sessionManager中session值，沒有的話，最終在AbstractSessionDAO.readSession(sessionID)中拋出異常。

解決方案

在程序中退出的地方，清除cookie：

//刪除cookie

Cookie co = new Cookie("username", "");

co.setMaxAge(0);// 設置立即過期

co.setPath("/");// 根目錄，整個網站有效

servletResponse.addCookie(co);

設置SimpleCookie的過期時間，和session、ehcache緩存時間保持一致；

@Bean

public SimpleCookie sessionIdCookie() {

//DefaultSecurityManager

SimpleCookie simpleCookie = new SimpleCookie();

//如果在Cookie中設置了"HttpOnly"屬性，那么通過程序(JS腳本、Applet等)將無法讀取到Cookie信息，這樣能防止XSS×××。

simpleCookie.setHttpOnly(true);

simpleCookie.setName("SHRIOSESSIONID");

simpleCookie.setMaxAge(86400000*3);

return simpleCookie;

}

手動實現shiro的logout方法，清除瀏覽器cookie；

重寫AbstractSessionDAO.readSession方法，如果session為null,清空瀏覽器cookie；

不做處理；實際項目運行中，不影響功能執行。

源碼

源碼已集成到項目中：

前篇

20200808新版本更新

版本升級及內容優化版本，改動內容：

版本更新，springboot從1.5+升級到2.1+；

權限緩存使用redis；

驗證碼使用redis；

權限驗證完善。

總結

以上是生活随笔為你收集整理的log中文乱码 springboot_springboot + shiro 权限注解、统一异常处理、请求乱码解决的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。