使用 Servlets 和 Servlet 過濾器

Spring Cloud Gateway Server MVC 是為基於 Servlet API 構建並部署到 Servlet 容器的 Servlet 棧 Web 應用程式而構建的。如果你的應用程式使用 Servlets 或 Servlet 過濾器，你可能需要注意它們的順序。

由於 Servlet 容器處理請求引數的方式，當 Spring WebMVC 應用程式接收到內容型別為 application/x-www-form-urlencoded 時，Servlet 容器會將這些引數與查詢引數合併為“請求”引數。Spring Cloud Gateway Server MVC 中包含一個特殊的 FormFilter bean，用於為下游應用程式重建表單體。任何在過濾器鏈執行之前讀取請求引數的 Servlet 過濾器都需要被排序在 FormFilter 之前。參見下面的示例。

MyFilter.java

import jakarta.servlet.Filter;
import org.springframework.cloud.gateway.server.mvc.filter.FormFilter;
import org.springframework.core.Ordered;

class MyFilter implements Filter, Ordered {

    @Override
    public int getOrder() {
        return FormFilter.FORM_FILTER_ORDER - 1;
    }

    @Override
    public void doFilter(ServletRequest request, ServletResponse response, FilterChain filterChain)
            throws IOException, ServletException {
        // ...
        filterChain.doFilter(request, response);
        // ...
    }
}