在SpringBoot項(xiàng)目維護(hù)過(guò)程中，版本升級(jí)是常見操作，但往往會(huì)引發(fā)一些兼容性問(wèn)題。本文記錄了將SpringBoot內(nèi)置Tomcat從8.5.51升級(jí)到9.0.75后遇到的兩個(gè)典型問(wèn)題：URL包含雙斜杠//導(dǎo)致404、DELETE請(qǐng)求報(bào)HttpRequestMethodNotSupportedException，并給出對(duì)應(yīng)的解決方案和原理分析。

一、URL包含//導(dǎo)致404問(wèn)題

問(wèn)題現(xiàn)象

Tomcat版本升級(jí)至9.0.75后，前端點(diǎn)擊菜單出現(xiàn)404錯(cuò)誤，排查發(fā)現(xiàn)請(qǐng)求URL中存在連續(xù)的雙斜杠（如/api//user/list），將Tomcat回退到8.5.51后問(wèn)題消失。

問(wèn)題原因

Tomcat 9.x對(duì)URL的規(guī)范化處理邏輯相比8.x更嚴(yán)格：

• Tomcat 8.5.51會(huì)自動(dòng)將URL中的連續(xù)斜杠//合并為單斜杠/，因此即使URL拼寫不規(guī)范也能正常訪問(wèn)；
• Tomcat 9.0.75默認(rèn)不再自動(dòng)合并連續(xù)斜杠，導(dǎo)致包含//的URL無(wú)法匹配后端接口，觸發(fā)404錯(cuò)誤。

解決方案

方案1：統(tǒng)一規(guī)范前端菜單URL配置（推薦）

從根源上解決問(wèn)題，檢查并修正所有菜單、前端請(qǐng)求的URL配置，將所有連續(xù)的//替換為單斜杠/。
示例：

• 錯(cuò)誤URL：/system//menu
• 修正后：/system/menu

方案2：配置Tomcat允許合并連續(xù)斜杠（應(yīng)急方案）

若暫時(shí)無(wú)法批量修正URL，可通過(guò)配置Tomcat參數(shù)恢復(fù)8.x的URL處理邏輯：

import org.apache.catalina.connector.Connector;
import org.springframework.boot.web.embedded.tomcat.TomcatServletWebServerFactory;
import org.springframework.boot.web.servlet.server.ServletWebServerFactory;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class TomcatConfig {
    @Bean
    public ServletWebServerFactory servletWebServerFactory() {
        TomcatServletWebServerFactory tomcat = new TomcatServletWebServerFactory();
        tomcat.addConnectorCustomizers((Connector connector) -> {
            // 開啟URL規(guī)范化，合并連續(xù)斜杠
            connector.setNormalizeUri(true);
            // Tomcat 9.x新增參數(shù)，允許路徑中的連續(xù)斜杠
            connector.setAttribute("allowBackSlash", true);
            connector.setAttribute("normalizePath", true);
        });
        return tomcat;
    }
}

二、DELETE請(qǐng)求報(bào)HttpRequestMethodNotSupportedException異常

問(wèn)題現(xiàn)象

前端發(fā)起DELETE請(qǐng)求時(shí)，后端拋出如下異常：

org.springframework.web.HttpRequestMethodNotSupportedException: Request method 'POST' not supported

問(wèn)題原因

瀏覽器原生只支持GET和POST請(qǐng)求，前端通常通過(guò)form表單+隱藏參數(shù)的方式模擬DELETE/PUT請(qǐng)求。SpringBoot中處理該場(chǎng)景的HiddenHttpMethodFilter過(guò)濾器默認(rèn)是關(guān)閉的（尤其是高版本SpringBoot），導(dǎo)致POST請(qǐng)求無(wú)法被轉(zhuǎn)換為DELETE請(qǐng)求，進(jìn)而觸發(fā)請(qǐng)求方法不支持的異常。

解決方案

方案1：開啟HiddenHttpMethodFilter（配置文件方式）

在application.properties或application.yml中添加配置：

# 開啟HiddenHttpMethodFilter過(guò)濾器，支持POST模擬DELETE/PUT請(qǐng)求
spring.mvc.hiddenmethod.filter.enabled=true

spring:
  mvc:
    hiddenmethod:
      filter:
        enabled: true

方案2：手動(dòng)注冊(cè)HiddenHttpMethodFilter（代碼方式）

若配置文件方式不生效，可手動(dòng)注冊(cè)過(guò)濾器：

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.filter.HiddenHttpMethodFilter;

@Configuration
public class WebConfig {
    @Bean
    public HiddenHttpMethodFilter hiddenHttpMethodFilter() {
        return new HiddenHttpMethodFilter();
    }
}

前端配合示例

前端需在POST表單中添加_method=DELETE隱藏參數(shù)：

<form action="/api/user/1" method="post">
    <input type="hidden" name="_method" value="DELETE">
    <button type="submit">刪除用戶</button>
</form>

補(bǔ)充說(shuō)明

1. HiddenHttpMethodFilter僅處理Content-Type為application/x-www-form-urlencoded的POST請(qǐng)求；
2. 若前端使用Axios等AJAX工具，可直接設(shè)置method: 'DELETE'，無(wú)需依賴該過(guò)濾器；
3. 過(guò)濾器優(yōu)先級(jí)：若項(xiàng)目中有自定義過(guò)濾器，需保證HiddenHttpMethodFilter執(zhí)行順序靠前。

三、總結(jié)

1. Tomcat 9.x對(duì)URL規(guī)范化更嚴(yán)格，需統(tǒng)一規(guī)范URL拼寫（避免//），或通過(guò)配置恢復(fù)8.x的URL處理邏輯；
2. SpringBoot中模擬DELETE/PUT請(qǐng)求需開啟HiddenHttpMethodFilter，核心配置為spring.mvc.hiddenmethod.filter.enabled=true；
3. 版本升級(jí)前建議先做小范圍驗(yàn)證，重點(diǎn)關(guān)注基礎(chǔ)組件（如Tomcat）的行為變更，提前規(guī)避兼容性問(wèn)題。

四、擴(kuò)展建議

1. 建立URL規(guī)范檢查機(jī)制：在前端工程中添加ESLint規(guī)則，禁止URL中出現(xiàn)連續(xù)斜杠；
2. 統(tǒng)一請(qǐng)求方式：新項(xiàng)目建議優(yōu)先使用RESTful API+AJAX（Axios/Fetch），減少表單模擬DELETE/PUT的場(chǎng)景；
3. 版本兼容：升級(jí)依賴前查閱官方變更日志，重點(diǎn)關(guān)注核心組件（Tomcat、Spring框架）的行為變更點(diǎn)。

以上就是SpringBoot升級(jí)Tomcat引發(fā)的問(wèn)題及解決方案的詳細(xì)內(nèi)容，更多關(guān)于SpringBoot升級(jí)Tomcat遇到的問(wèn)題的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章！

最新評(píng)論