在Tomcat中配置Servlet，如果要对一些Servlet进行请求路径的映射时，可以使用注解的方式来实现，这样可以缓解web.xml文件的压力，避免web.xml文件过于臃肿，加快文件的解析提高Tomcat启动速度。
注解虽好，但也有坑。
我们都知道，从JavaEE6（Tomcat3，Servlet3.0）开始，Servlet才支持注解的应用。
在Tomcat7之前的版本，默认的情况下，如果要使用注解来映射Servlet，是需要在web.xml中开启对Servlet注解的支持，这样使用注解的进行映射的时候才有效果，实际的情况是，Tomcat忽略了对Servlet实体类上的注解应用。
打开web.xml文件，可以看到这样的约束：
<?xmlversion="1.0"encoding="UTF-8"?> <web-appxmlns: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">
</web-app> |
而实际上，这一段约束中，还隐藏了这么一个属性：
<?xmlversion="1.0"encoding="UTF-8"?> <web-appxmlns: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"metadata-complete="true">
</web-app> |
没错哈，导致Servlet注解没有效果的，就是这个属性，它的意思是忽略Servlet实体类上的注解，不去扫描这些注解，所以就不起作用。
如果使用了注解而没有起到任何的效果，在保证Servlet能在web.xml中正常执行的前提下，很大的可能就是因为没有开始对注解的应用。
如何开始对Servlet注解的应用呢？
只需要把metadata-complete属性的值设置为false就可以了，让Tomcat不忽略Servlet实体类的注解就可以了。
另外不得不提的一点，到了Tomcat7以后的版本，改为了默认情况下是支持Servlet注解应用的。当然，也有例外的情况，比如同样是Tomcat7，在这个大版本中的某些小版本有可能不是默认支持Servlet注解的，这里需要注意了。
总的来说，不管Tomcat是否默认支持Servlet注解，最好是把这个属性的值设置为false，防止你的项目Copy到其他系统中运行的时候出现问题，这就是你的问题了。