在SpringBoot里自定義Spring MVC配置的三種方法

更新時間：2026年03月21日 14:16:47 作者：希望永不加班

SpringBoot幫我們自動配好了 MVC 的核心組件,但實際開發(fā)中,光用默認(rèn)配置肯定不夠今天就教你 3 種自定義 Spring MVC 配置的方法,從簡單到復(fù)雜,新手也能一步步跟著做,需要的朋友可以參考下

前言

SpringBoot 幫我們自動配好了 MVC 的核心組件，但實際開發(fā)中，光用默認(rèn)配置肯定不夠：

比如想改靜態(tài)資源路徑、加自定義攔截器、換消息轉(zhuǎn)換器、調(diào)整請求參數(shù)解析規(guī)則……這些都需要我們自定義 Spring MVC 配置。

今天就教你 3 種自定義 Spring MVC 配置的方法，從簡單到復(fù)雜，新手也能一步步跟著做，再也不用對著默認(rèn)配置束手無策。

先搞懂SpringBoot 里自定義 MVC 配置的“規(guī)矩”

SpringBoot 為了不讓我們亂改配置，定了一個核心規(guī)則：
想要自定義 MVC 配置，必須實現(xiàn) WebMvcConfigurer 接口（或繼承 WebMvcConfigurerAdapter，但 3.x 已廢棄），并加上 @Configuration 注解。

這個接口里全是默認(rèn)方法（不用全部實現(xiàn)，按需重寫），覆蓋了 MVC 配置的所有場景：靜態(tài)資源、攔截器、消息轉(zhuǎn)換器、視圖解析器……

先給個基礎(chǔ)模板，所有自定義配置都基于這個結(jié)構(gòu)：

importorg.springframework.context.annotation.Configuration;
importorg.springframework.web.servlet.config.annotation.WebMvcConfigurer;
// 標(biāo)記這是配置類，SpringBoot 啟動時會掃描并加載
@Configuration
publicclassCustomWebMvcConfigimplementsWebMvcConfigurer{
// 下面重寫需要自定義的方法即可
// 自定義靜態(tài)資源路徑、添加攔截器、配置消息轉(zhuǎn)換器……
}

踩坑提醒：千萬別加 @EnableWebMvc 注解！
加了這個注解，SpringBoot 會完全關(guān)閉默認(rèn)的 MVC 自動配置，所有配置都要你自己寫（包括 DispatcherServlet、參數(shù)解析器這些核心組件），新手大概率會配崩。

最簡單的自定義——修改靜態(tài)資源訪問路徑

SpringBoot 默認(rèn)的靜態(tài)資源路徑是 classpath:/static/、classpath:/public/、classpath:/resources/，比如你在 static 下放個 test.jpg，訪問地址是 http://localhost:8080/test.jpg。

如果想加自定義路徑（比如 classpath:/images/），或者改默認(rèn)優(yōu)先級，重寫 addResourceHandlers 方法就行：

importorg.springframework.context.annotation.Configuration;
importorg.springframework.web.servlet.config.annotation.ResourceHandlerRegistry;
importorg.springframework.web.servlet.config.annotation.WebMvcConfigurer;
@Configuration
publicclassCustomWebMvcConfigimplementsWebMvcConfigurer{
// 自定義靜態(tài)資源配置
@Override
publicvoidaddResourceHandlers(ResourceHandlerRegistry registry){
// 1. 添加自定義靜態(tài)資源路徑：classpath:/images/
// addResourceHandler：前端訪問路徑前綴
// addResourceLocations：本地資源實際路徑
        registry.addResourceHandler("/images/**")// 前端訪問 http://localhost:8080/images/xxx.jpg
addResourceLocations("classpath:/images/");// 對應(yīng)項目里的 src/main/resources/images/
// 2. 覆蓋默認(rèn)靜態(tài)資源路徑（可選，不推薦，保留默認(rèn)更靈活）
// registry.addResourceHandler("/**")
//         .addResourceLocations("classpath:/my-static/");
}
}

測試：在 src/main/resources/images/ 下放 logo.png，訪問 http://localhost:8080/images/logo.png 就能看到圖片。

最常用的自定義——添加全局?jǐn)r截器

開發(fā)中經(jīng)常需要用攔截器做登錄校驗、接口限流、日志記錄，這是自定義 MVC 最核心的場景。

步驟分兩步：先寫攔截器類，再在 MVC 配置里注冊。

第一步：寫自定義攔截器

importjakarta.servlet.http.HttpServletRequest;
importjakarta.servlet.http.HttpServletResponse;
importorg.springframework.web.servlet.HandlerInterceptor;
importorg.springframework.web.servlet.ModelAndView;
// 自定義登錄攔截器
publicclassLoginInterceptorimplementsHandlerInterceptor{
// 請求處理前執(zhí)行（核心邏輯寫這里）
@Override
publicbooleanpreHandle(HttpServletRequest request,HttpServletResponse response,Object handler)throwsException{
// 模擬：從請求頭獲取 token，判斷是否登錄
String token = request.getHeader("token");
if(token ==null||!"admin123".equals(token)){
// 未登錄，返回 401 狀態(tài)碼
            response.setStatus(401);
            response.getWriter().write("未登錄，請先登錄！");
returnfalse;// 攔截請求，不往下走
}
returntrue;// 放行請求
}
// 請求處理后執(zhí)行（可選）
@Override
publicvoidpostHandle(HttpServletRequest request,HttpServletResponse response,Object handler,ModelAndView modelAndView)throwsException{
HandlerInterceptor.super.postHandle(request, response, handler, modelAndView);
}
// 整個請求完成后執(zhí)行（可選，比如清理資源）
@Override
publicvoidafterCompletion(HttpServletRequest request,HttpServletResponse response,Object handler,Exception ex)throwsException{
HandlerInterceptor.super.afterCompletion(request, response, handler, ex);
}
}

第二步：在 MVC 配置里注冊攔截器

importorg.springframework.context.annotation.Bean;
importorg.springframework.context.annotation.Configuration;
importorg.springframework.web.servlet.config.annotation.InterceptorRegistry;
importorg.springframework.web.servlet.config.annotation.WebMvcConfigurer;
@Configuration
publicclassCustomWebMvcConfigimplementsWebMvcConfigurer{
// 把攔截器注冊為 Bean，Spring 才能管理
@Bean
publicLoginInterceptorloginInterceptor(){
returnnewLoginInterceptor();
}
// 注冊攔截器，并配置攔截規(guī)則
@Override
publicvoidaddInterceptors(InterceptorRegistry registry){
        registry.addInterceptor(loginInterceptor())
.addPathPatterns("/**")// 攔截所有請求
.excludePathPatterns("/login","/hello");// 排除登錄、hello 接口（不攔截）
}
}

測試：

訪問 http://localhost:8080/hello：不用 token，正常返回（排除攔截）；
訪問 http://localhost:8080/user/info：不加 token 會返回 401，加 token: admin123 請求頭才放行。

進(jìn)階自定義——替換/新增消息轉(zhuǎn)換器

Spring MVC 默認(rèn)用 MappingJackson2HttpMessageConverter 處理 JSON 序列化/反序列化，但有時我們想自定義規(guī)則（比如日期格式、空值處理），或者換用 FastJSON 作為轉(zhuǎn)換器。

以“自定義 Jackson 日期格式”為例：

importcom.fasterxml.jackson.databind.ObjectMapper;
importcom.fasterxml.jackson.databind.SerializationFeature;
importcom.fasterxml.jackson.datatype.jsr310.JavaTimeModule;
importcom.fasterxml.jackson.datatype.jsr310.ser.LocalDateTimeSerializer;
importorg.springframework.context.annotation.Bean;
importorg.springframework.context.annotation.Configuration;
importorg.springframework.http.converter.HttpMessageConverter;
importorg.springframework.http.converter.json.MappingJackson2HttpMessageConverter;
importorg.springframework.web.servlet.config.annotation.WebMvcConfigurer;
importjava.time.LocalDateTime;
importjava.time.format.DateTimeFormatter;
importjava.util.List;
@Configuration
publicclassCustomWebMvcConfigimplementsWebMvcConfigurer{
// 自定義 JSON 消息轉(zhuǎn)換器
@Override
publicvoidconfigureMessageConverters(List<HttpMessageConverter<?>> converters){
// 1. 創(chuàng)建 Jackson 對象映射器，自定義序列化規(guī)則
ObjectMapper objectMapper =newObjectMapper();
// 處理 LocalDateTime 日期格式
JavaTimeModule javaTimeModule =newJavaTimeModule();
        javaTimeModule.addSerializer(LocalDateTime.class,
newLocalDateTimeSerializer(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss")));
        objectMapper.registerModule(javaTimeModule);
// 關(guān)閉默認(rèn)的日期序列化（避免轉(zhuǎn)成時間戳）
        objectMapper.disable(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS);
// 2. 創(chuàng)建自定義的消息轉(zhuǎn)換器
MappingJackson2HttpMessageConverter converter =newMappingJackson2HttpMessageConverter();
        converter.setObjectMapper(objectMapper);
// 3. 把自定義轉(zhuǎn)換器加到列表最前面（優(yōu)先級最高）
        converters.add(0, converter);
}
}

測試：返回包含 LocalDateTime 類型的對象時，日期會按 yyyy-MM-dd HH:mm:ss 格式顯示，而不是默認(rèn)的時間戳或 ISO 格式。