java.lang.IllegalArgumentException：过滤器映射必须指定 <url-pattern> 或 <servlet-name>

Posted 2023-02-26

【中文标题】java.lang.IllegalArgumentException：过滤器映射必须指定 <url-pattern> 或 <servlet-name>

【英文标题】：java.lang.IllegalArgumentException: Filter mapping must specify either a <url-pattern> or a <servlet-name>

【发布时间】：2012-01-24 18:57:15

【问题描述】：

我用下一个 web.xml 创建了非常简单的 REST 应用程序：

<context-param>
    <param-name>resteasy.scan</param-name>
<param-value>true</param-value>
</context-param>

<listener>
    <listener-class>org.jboss.resteasy.plugins.server.servlet.ResteasyBootstrap</listener-class>
</listener>

<servlet>
    <servlet-name>Resteasy</servlet-name>
    <servlet-class>org.jboss.resteasy.plugins.server.servlet.HttpServletDispatcher</servlet-class>
</servlet>

<servlet-mapping>
    <servlet-name>Resteasy</servlet-name>
    <url-pattern>/rest/*</url-pattern>
</servlet-mapping>

我正在使用 servlet 3.0 规范和 Tomcat 7.0.23。不幸的是，它总是失败：

Caused by: java.lang.IllegalArgumentException: Filter mapping must specify either a <url-pattern> or a <servlet-name>
    at org.apache.catalina.core.StandardContext.validateFilterMap(StandardContext.java:2995)
    at org.apache.catalina.core.StandardContext.addFilterMap(StandardContext.java:2954)

我不知道问题出在哪里...我的代码中没有使用过滤器，我该如何解决？

【参考方案1】：

这与RESTEasy issue 577 有关。要解决此问题，您需要将 metadata-complete="true" 添加到您的 /WEB-INF/web.xml 的 <web-app> 根声明中。

<web-app 
    xmlns="http://java.sun.com/xml/ns/javaee"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"
    version="3.0" metadata-complete="true">

    <!-- Config here. -->

</web-app>

这样 Tomcat 将假定 /WEB-INF/web.xml 是完整的，并且不会扫描 JAR 以获取 web.xml 片段中的其他元数据信息，如果 RESTEasy 显然包含错误/不完整声明的过滤器。

【参考方案2】：

当然，添加 'metadata-complete="true"' 将阻止任何其他 jar 对 web.xml 做出贡献，包括 RichFaces 和 Seam。最好从部署中排除有问题的 JAR 文件。就我而言，是 async-http-servlet-3.0-2.3.3.Final.jar 得罪了。

【参考方案3】：

这是 Tomcat 7（版本 that reply 的类似问题和linked Tomcat 7 bugzilla ticket。