如何将web.xml转为@WebServlet注解？Servlet3.1过滤器注解配置问题

没问题，这事儿很简单，咱们直接基于你现有的过滤器类来改，不用新建任何类，步骤如下：

第一步：给原有过滤器类添加@WebFilter注解 #

首先找到你那个未加注解的过滤器类，在类上面加上@WebFilter注解，把web.xml里的配置参数一一对应进去就行。举个例子，假设你web.xml里的过滤器配置是这样的：

MyOldFilter com.yourpackage.YourExistingFilter maxSize 1024 MyOldFilter /api/* REQUEST INCLUDE

那你修改后的过滤器类应该是这样：

import javax.servlet.annotation.WebFilter;
import javax.servlet.annotation.WebInitParam;
import javax.servlet.DispatcherType;

@WebFilter(
    filterName = "MyOldFilter", // 和web.xml里的<filter-name>一致
    urlPatterns = "/api/*", // 对应<url-pattern>
    initParams = {
        @WebInitParam(name = "maxSize", value = "1024") // 对应<init-param>
    },
    dispatcherTypes = {DispatcherType.REQUEST, DispatcherType.INCLUDE} // 对应<dispatcher>
)
public class YourExistingFilter implements javax.servlet.Filter {

    // 这里保留你原来的init()、doFilter()、destroy()方法，完全不用改
    @Override
    public void init(javax.servlet.FilterConfig filterConfig) throws javax.servlet.ServletException {
        // 原有逻辑不变
    }

    @Override
    public void doFilter(javax.servlet.ServletRequest request, javax.servlet.ServletResponse response, javax.servlet.FilterChain chain) throws java.io.IOException, javax.servlet.ServletException {
        // 原有逻辑不变
    }

    @Override
    public void destroy() {
        // 原有逻辑不变
    }
}

第二步：移除Web.xml里的过滤器配置 #

把web.xml中对应的<filter>和<filter-mapping>两个配置块完全删掉，避免容器重复注册这个过滤器，导致不必要的问题。

关键注意事项 #

• 容器版本兼容：确保你用的Servlet容器（比如Tomcat 8.x+、Jetty 9.x+）支持Servlet 3.1，毕竟你web.xml里已经声明了version="3.1"，这一步应该没问题，但还是要确认下。
• metadata-complete属性：检查web.xml的<web-app>标签里有没有metadata-complete="true"，如果有的话必须改成false——这个属性设为true时，容器会忽略所有注解配置，只认web.xml里的内容。
• 注解包路径：别搞错注解的包，Servlet 3.1用的是javax.servlet.annotation.WebFilter，不是Jakarta EE的jakarta.servlet.annotation.WebFilter（那是Servlet 5.0+的）。
• 参数对应准确：如果你的过滤器有多个初始化参数，要逐个用@WebInitParam声明；如果dispatcherTypes只有默认的REQUEST，可以省略这个参数。

这样改完之后，你的应用运行逻辑和之前完全一致，只是把配置从web.xml迁移到了注解上，不用新建任何类，完美复用原有代码。

内容的提问来源于stack exchange，提问作者Passionate developer