使用 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);
        // ...
    }
}