使用 Servlets 和 Servlet 过滤器

DeepSeek V3 中英对照 Working with Servlets and Servlet Filters

Spring Cloud Gateway Server MVC 是为基于 Servlet API 构建并部署到 Servlet 容器的 Servlet 栈 Web 应用程序而构建的。如果你的应用程序使用了 Servlet 或 Servlet 过滤器，你可能需要注意它们的顺序。

由于 Servlet 容器处理请求参数的方式，当 Spring WebMVC 应用程序接收到 application/x-www-form-urlencoded 内容类型时，Servlet 容器会将这些参数与查询参数合并为“请求”参数。Spring Cloud Gateway Server MVC 中包含了一个特殊的 FormFilter bean，用于为下游应用程序重建表单体。在过滤器链运行之前读取请求参数的任何 Servlet 过滤器都需要在 FormFilter 之前排序。请参见下面的示例。

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

java