「illegalargument」IllegalArgumentException 异常时一个不易觉察的原因

illegalargument

对于一个老开发来说，对web程序的运行原理了解的不能再了解了有木有？

譬如web程序的主角servlet，第一步，new 一个 servlet；第二步，将新new出来的servlet在配置文件web.xml 中一个配置；over ！

接下来就是启动服务开始访问了，可是，人在河边走，哪有不湿鞋的？

今天在写登录案例时，便按照上述早已“炉火纯青”的例行化步骤创建servlet，几秒后，当程序自动加载后，控制台一通输出，报了一个非常“简单”的异常，很有意思，记录一下，供大家参考，还是先上报错信息吧

严重: ContainerBase.addChild: start:

org.apache.catalina.LifecycleException: failed to start component [StandardEngine[Catalina].StandardHost[localhost].Standardcontext[/LoginCaseDemo2]]

at org.apache.catalina.util.LifecycleBase.start(LifecycleBase.java:154)

at org.apache.catalina.core.containerBase.addChildInternal(ContainerBase.java:901)

at org.apache.catalina.core.ContainerBase.addChild(ContainerBase.java:877)

at org.apache.catalina.core.StandardHost.addChild(StandardHost.java:649)

at org.apache.catalina.startup.HostConfig.deployDescriptor(HostConfig.java:672)

at org.apache.catalina.startup.HostConfig$DeployDescriptor.run(HostConfig.java:1859)

at java.util.concurrent.Executors$RunnableAdapter.call(Executors.java:511)

at java.util.concurrent.FutureTask.run(FutureTask.java:266)

at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1142)

at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:617)

at java.lang.Thread.run(Thread.java:745)

Caused by: java.lang.illegalargumentException: The servlets named [RegiserServlet] and [com.icbc.logincase.servlet.RegiserServlet] are both mAPPed to the url-pattern [/RegiserServlet] which is not permitted

at org.apache.catalina.deploy.WebXml.addServletMapping(WebXml.java:293)

at org.apache.catalina.startup.ContextConfig.processAnnotationWebServlet(ContextConfig.java:2410)

at org.apache.catalina.startup.ContextConfig.processAnnotationsStream(ContextConfig.java:2085)

at org.apache.catalina.startup.ContextConfig.processAnnotationsFile(ContextConfig.java:2046)

at org.apache.catalina.startup.ContextConfig.processAnnotationsFile(ContextConfig.java:2039)

at org.apache.catalina.startup.ContextConfig.webConfig(ContextConfig.java:1304)

at org.apache.catalina.startup.ContextConfig.con figureStart(ContextConfig.java:889)

at org.apache.catalina.startup.ContextConfig.lifecycleEvent(ContextConfig.java:386)

at org.apache.catalina.util.LifecycleSupport.fireLifecycleEvent(LifecycleSupport.java:117)

at org.apache.catalina.util.LifecycleBase.fireLifecycleEvent(LifecycleBase.java:90)

at org.apache.catalina.core.StandardContext.startInternal(StandardContext.java:5380)

at org.apache.catalina.util.LifecycleBase.start(LifecycleBase.java:150)

... 10 more

一月 16, 2019 5:27:15 上午 org.apache.catalina.startup.HostConfig deployDescriptor

严重: ERROR deploying configuration descriptor D:\developer\apache-tomcat-7.0.57\conf\Catalina\localhost\LoginCaseDemo2.xml

java.lang.IllegalStateException: ContainerBase.addChild: start: org.apache.catalina.LifecycleException: Failed to start component [StandardEngine[Catalina].StandardHost[localhost].StandardContext[/LoginCaseDemo2]]

at org.apache.catalina.core.ContainerBase.addChildInternal(ContainerBase.java:904)

at org.apache.catalina.core.ContainerBase.addChild(ContainerBase.java:877)

at org.apache.catalina.core.StandardHost.addChild(StandardHost.java:649)

at org.apache.catalina.startup.HostConfig.deployDescriptor(HostConfig.java:672)

at org.apache.catalina.startup.HostConfig$DeployDescriptor.run(HostConfig.java:1859)

at java.util.concurrent.Executors$RunnableAdapter.call(Executors.java:511)

at java.util.concurrent.FutureTask.run(FutureTask.java:266)

at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1142)

at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:617)

at java.lang.Thread.run(Thread.java:745)

对于上述报错信息，我相信一个初级开发都应该不会陌生，字面意思很清楚，首先是 StandardEngine 引擎启动失败了，所以导致Tomcat挂了，为何StandardEngine 引擎启动失败呢？

是因为 Caused by: java.lang.IllegalArgumentException: The servlets named [RegiserServlet] and [com.icbc.logincase.servlet.RegiserServlet] are both mapped to the url-pattern [/RegiserServlet] which is not permitted 即 RegiserServlet 重复配置了，这是不被允许的

针对这个问题的处理早已驾轻就熟了，那就检查吧打开web.xml 文件检查

<?xml version="1.0" encoding="UTF-8"?>

<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xmlns="http://java.sun.com/xml/ns/javaee"

xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"

id="webapp_ID" version="3.0">

<display-name>LoginCaseDemo2</display-name>

<servlet-name>RegiserServlet</servlet-name>

<servlet-class>com.icbc.logincase.servlet.RegiserServlet</servlet-class>

</servlet>

<servlet-mapping>

<servlet-name>RegiserServlet</servlet-name>

<url-pattern>/RegiserServlet</url-pattern>

</servlet-mapping>

</web-app>

配置文件中针对这个servlet的配置干净到完美无缺好不好？没有任何臃余好不好？检查了好几遍，依然报错，我重启了服务，依然报上述错误，我有点纳闷了，这是什么鬼？

既然不是配置文件的问题，会不会是servlet的问题呢，于是我点进去，查看了 RegiserServlet，

RegiserServlet 它以一副初生婴儿般人畜无害的模样展现在我面前，也是清纯到完美无缺有木有?它有神马错？

这一刻，我有点困惑了，又出现什么幺蛾子了？之前都很顺利，没碰到过这事儿啊。

我静静的思考着……

我想象着曾经没有出问题时servlet的创建过程，之前我创建servlet的习惯性写法是new一个java类，直接继承HttpServlet，然后自己实现doGet（）等需要实现的方法，一副很高大上的样子。

而今天我在创建servlet时一反常态，直接new 了一个servlet，于是乎就出现了上述的问题，那么这直接new 出来的servlet与我自己写的有什么区别呢？

我的目光聚焦在了@WebServlet("/RegiserServlet") 注解上，直接new出来的servlet，比之我自己实现的servlet，好像就多了这么一行有效代码，于是我将该行注解删去，重启服务，正常启动，不再报错。

接着，我又验证了，保留注解，删去web.xml中的关于该servlet声明和映射的配置，服务依然正常启动，servlet也可以正常使用。

自此该问题搞定了！

这不是什么复杂的问题，但却是非常迷惑人的问题，根据我们的开发习惯，甚至有时很难觉察到，所以，我感觉非常有趣，记录一下，以便可以帮助未来也陷入此误区的人！

顺便，也分享一下关于@WebServlet("/RegiserServlet") 的一些知识吧，在servlet3.0以后，对于servlet的配置，我们便多了一种选择，可以不用再web.xml里面配置servlet，只需要加上@WebServlet注解就可以修改该servlet的属性了：

下面是@WebServlet的属性列表。

属性名	类型	描述
name	String	指定Servlet 的 name 属性，等价于 <servlet-name>。如果没有显式指定，则该 Servlet 的取值即为类的全限定名。
value	String[]	该属性等价于 urlPatterns 属性。两个属性不能同时使用。
urlPatterns	String[]	指定一组 Servlet 的 URL 匹配模式。等价于<url-pattern>标签。
loadOnStartup	int	指定 Servlet 的加载顺序，等价于 <load-on-startup>标签。
initparams	WebInitParam[]	指定一组 Servlet 初始化参数，等价于<init-param>标签。
asyncSupported	boolean	声明 Servlet 是否支持异步操作模式，等价于<async-supported> 标签。
description	String	该 Servlet 的描述信息，等价于 <description>标签。
displayName	String	该 Servlet 的显示名，通常配合工具使用，等价于 <display-name>标签。

从表中可以看出，web.xml可以配置的servlet属性，在@WebServlet 都可以配置，而且注解用起来似乎更简单了，但是，虽然如此，我好像还是习惯在web.xml中去配置，略去为了向下兼容这么冠冕堂皇高大上的说辞，我要学着与时俱进呐！哈哈！

IllegalArgumentException 异常时一个不易觉察的原因

illegalargument

相关阅读

栏目导航

推荐阅读

热门阅读