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

本文链接：https://blog.csdn.net/jinling2015/article/details/86501529

对于一个老开发来说，对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.processAnnotationsFile(ContextConfig.java:2039)
   at org.apache.catalina.startup.ContextConfig.processAnnotationsFile(ContextConfig.java:2039)
   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.configureStart(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>
<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>标签。