一.導(dǎo)言

 SpringBoot的真正核心是快速整合以及自動(dòng)裝配，所以在spring家族中springBoot不僅整合了Spring的IOC容器還兼容了WebServlet容器；這使得springBoot項(xiàng)目不僅支持快速開發(fā)微服務(wù)，同時(shí)具備開發(fā)MVC模式下的項(xiàng)目。

其中MVC模式的實(shí)現(xiàn)者之一就是WebServlet；由于springBoot的整合，在其項(xiàng)目中開發(fā)WebServlet也是可行方案之一。但是在使用servlet技術(shù)時(shí)我們遇到了一個(gè)問題：即在SpringBoot中，以Bean的方式注冊(cè)servlet需要自定義兩個(gè)及以上的servlet。

這是為什么呢？

二.測試驗(yàn)證問題

 首先驗(yàn)證一個(gè)servlet的情況

先配置servlet實(shí)現(xiàn)類：

public class OneServlet extends HttpServlet {
    @Override
    protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
        System.out.println("servlet 1 的實(shí)現(xiàn)類");
        resp.getWriter().print("this is servlet 1");
    }
}

在config配置類中注冊(cè)這個(gè)servletBean：

@Configuration
public class RegisterBean {
    @Bean
    public OneServlet createOneServlet(){
        //注冊(cè)servlet 1
        return new OneServlet();
    }
}

直接啟動(dòng)springBoot啟動(dòng)器查看是否可以完成一次servlet的請(qǐng)求

地址欄輸入：

http://localhost:9000/createOneServlet/

或者：

http://localhost:9000/OneServlet/

顯示都是錯(cuò)誤頁面：

 驗(yàn)證兩個(gè)servlet的情況

拓展一個(gè)servlet實(shí)現(xiàn)類：

public class TwoServlet extends HttpServlet {
    @Override
    protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
        System.out.println("servlet 2 的實(shí)現(xiàn)類");
        resp.getWriter().print("this is servlet 2");
    }
}

以及使用Bean的方式完成注入：

@Configuration
public class RegisterBean {
    @Bean
    public OneServlet createOneServlet(){
        //注冊(cè)servlet 1
        return new OneServlet();
    }
        @Bean
    public TwoServlet createTwoServlet(){
        //注冊(cè)servlet 2
        return new TwoServlet();
    }
}

再次啟動(dòng)springBoot啟動(dòng)器：

運(yùn)行：

http://localhost:9000/createOneServlet/

結(jié)果可以拿到請(qǐng)求，正常處理

 運(yùn)行：

http://localhost:9000/createTwoServlet/

結(jié)果依舊可以拿到，正常處理請(qǐng)求：

 這就出現(xiàn)了剛開始提到的那個(gè)問題：springBoot項(xiàng)目運(yùn)行時(shí)，一個(gè)servlet無法進(jìn)行請(qǐng)求，當(dāng)有兩個(gè)時(shí)卻可以進(jìn)行請(qǐng)求

 解決這問題之前，我們需要一點(diǎn)前言知識(shí)，那就是需要先了解SpringMVC中的DispatcherServlet

三.解決單servlet無法正常請(qǐng)求的問題

 DispatcherServlet 是 Spring MVC 框架的核心組件，它充當(dāng)前端控制器（Front Controller）的角色，負(fù)責(zé)接收所有的 HTTP 請(qǐng)求并將其分發(fā)到相應(yīng)的處理器（Handler）。通過這種方式，DispatcherServlet 實(shí)現(xiàn)了請(qǐng)求的集中管理和分發(fā)。請(qǐng)求分發(fā)：接收所有進(jìn)入的應(yīng)用程序的HTTP請(qǐng)求，并根據(jù)配置將它們分發(fā)給合適的處理器（Controller）。

 當(dāng)然DispatcherServlet的功能還有很多，我們只把關(guān)系到問題的部分單獨(dú)拿出來。我們知道SpringMVC在JavaWeb的基礎(chǔ)之上，演化了DispatcherServlet，它的本質(zhì)依舊是一個(gè)servlet，在SpringMVC中將其單獨(dú)拿出來作為前后端連接的大腦，通常它會(huì)將前端所有的請(qǐng)求都攔截下來，然后經(jīng)過一系列驗(yàn)證之后移交給controller處理，處理完成之后又返回給它，返回給視圖層。

由于springBoot中整合了SpringMVC，故而DispatcherServlet存在于spring容器中的。

 回到剛剛的問題，一個(gè)servlet為什么執(zhí)行不起來，這還得分析我們注入servlet的方式

@Bean
    public OneServlet createOneServlet(){
        //注冊(cè)servlet 1
        return new OneServlet();
    }

 由于我們注入使用的是最簡單的注入方式，并沒有配置這個(gè)servlet的請(qǐng)求路徑；

DeepSeek：如果沒有顯式配置路徑映射，Spring Boot 會(huì)嘗試為 Servlet 分配默認(rèn)路徑，通常是 Servlet 的名稱或類名的小寫形式。如果默認(rèn)路徑與其他映射沖突，或 Servlet 未正確注冊(cè)，可能導(dǎo)致無法訪問。

在第一種情況下，springBoot是在嘗試進(jìn)行為servlet命名的，只是為其命名的映射路徑剛好和DispatcherServlet的攔截請(qǐng)求沖突了，故而失敗了

我們?cè)谑〉那闆r下編寫一個(gè)controller，看相同的請(qǐng)求是不是交給DispatcherServlet處理了

controller：

@RestController
public class ServletTest {
    @GetMapping("/createOneServlet/")
    public String test(){
        return "return from Spring MVC";
    }
}

和第一次失敗測試一樣的請(qǐng)求：

http://localhost:9000/createOneServlet/

結(jié)果

 可以發(fā)現(xiàn)，配置一個(gè)controller之后確實(shí)請(qǐng)求被DispatcherServlet接管了，故而有springMVC框架進(jìn)行返回

知道了問題所在就可以進(jìn)行修改了，推薦兩種解決方案

1.更改DispatcherServlet的默認(rèn)攔截路徑

在SpringBoot中DispatcherServlet的默認(rèn)攔截路徑是  "/*" ;故而將其改到其它位置后，他就不會(huì)影響SpringBoot為沒有配置映射路徑的servlet命名了

更改application.properties文件：

spring.mvc.servlet.path= /test/

將DispatcherServlet的默認(rèn)匹配路徑更改到   “ /test/* ”  下

注銷controller類的實(shí)現(xiàn)：

//    @GetMapping("/createOneServlet/")
//    public String test(){
//        return "return from Spring MVC";
//    }

再次啟動(dòng)，測試單servlet未配置路徑是否有問題：

http://localhost:9000/createOneServlet/

結(jié)果：

可以看到，servlet成功將其請(qǐng)求處理了

2.配置單個(gè)servlet的請(qǐng)求路徑

配置servlet實(shí)現(xiàn)類使用@WebServlet注解：

@WebServlet(urlPatterns = "/createOneServlet")
public class OneServlet extends HttpServlet {
    @Override
    protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
        System.out.println("servlet 1 的實(shí)現(xiàn)類");
        resp.getWriter().print("this is servlet 1");
    }
}

在springBoot啟動(dòng)器上配置自動(dòng)掃描servlet的注解@ServletComponentScan：

@SpringBootApplication
@ServletComponentScan
public class ServletTestApplication {
    public static void main(String[] args) {
        SpringApplication.run(ServletTestApplication.class, args);
    }
}

啟動(dòng)測試：

http://localhost:9000/createOneServlet/

結(jié)果：

 可以發(fā)現(xiàn)依舊運(yùn)行出來了結(jié)果

如上就是推薦在SpringBoot中注冊(cè)servlet的兩種方式

為什么兩個(gè)自定義servlet不寫映射卻可以呢？

DeepSeek：兩個(gè)自定義 Servlet 可以訪問的原因

自動(dòng)注冊(cè)：當(dāng)有多個(gè) Servlet 時(shí)，Spring Boot 會(huì)為每個(gè) Servlet 生成默認(rèn)路徑，通常基于類名或者Bean。
路徑唯一性：多個(gè) Servlet 的默認(rèn)路徑通常不會(huì)沖突，因此可以正常訪問。

也就是基于這樣的原因，DispatcherServlet沒有產(chǎn)生攔截，因?yàn)檫@兩個(gè)自定義servlet已經(jīng)在Servlet容器中完成注冊(cè)，根據(jù)Java servlet的匹配規(guī)范，即最長匹配原則，/(類名|Bean)的匹配長度比DispatcherServlet /* 精度更高，故而兩個(gè)servlet的情況下，即使不修改SpringMVC的配置依舊可以正常訪問。

到此這篇關(guān)于SpringBoot集成WebServlet出現(xiàn)自定義servlet請(qǐng)求失敗的問題解決方案的文章就介紹到這了,更多相關(guān)SpringBoot集成WebServlet內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評(píng)論