一.導(dǎo)言

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

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

這是為什么呢？

二.測試驗證問題

 首先驗證一個servlet的情況

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

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

在config配置類中注冊這個servletBean：

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

直接啟動springBoot啟動器查看是否可以完成一次servlet的請求

地址欄輸入：

http://localhost:9000/createOneServlet/

或者：

http://localhost:9000/OneServlet/

顯示都是錯誤頁面：

 驗證兩個servlet的情況

拓展一個servlet實現(xiàn)類：

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

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

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

再次啟動springBoot啟動器：

運行：

http://localhost:9000/createOneServlet/

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

 運行：

http://localhost:9000/createTwoServlet/

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

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

 解決這問題之前，我們需要一點前言知識，那就是需要先了解SpringMVC中的DispatcherServlet

三.解決單servlet無法正常請求的問題

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

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

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

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

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

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

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

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

我們在失敗的情況下編寫一個controller，看相同的請求是不是交給DispatcherServlet處理了

controller：

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

和第一次失敗測試一樣的請求：

http://localhost:9000/createOneServlet/

結(jié)果

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

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

1.更改DispatcherServlet的默認攔截路徑

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

更改application.properties文件：

spring.mvc.servlet.path= /test/

將DispatcherServlet的默認匹配路徑更改到   “ /test/* ”  下

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

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

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

http://localhost:9000/createOneServlet/

結(jié)果：

可以看到，servlet成功將其請求處理了

2.配置單個servlet的請求路徑

配置servlet實現(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 的實現(xiàn)類");
        resp.getWriter().print("this is servlet 1");
    }
}

在springBoot啟動器上配置自動掃描servlet的注解@ServletComponentScan：

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

啟動測試：

http://localhost:9000/createOneServlet/

結(jié)果：

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

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

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

DeepSeek：兩個自定義 Servlet 可以訪問的原因

自動注冊：當(dāng)有多個 Servlet 時，Spring Boot 會為每個 Servlet 生成默認路徑，通?；陬惷蛘連ean。
路徑唯一性：多個 Servlet 的默認路徑通常不會沖突，因此可以正常訪問。

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

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

最新評論