创建Spring MVC项目时WAR验证失败问题求助

排查步骤 #

• 检查WEB-INF/web.xml的语法正确性：查看是否存在未闭合的标签、拼写错误的元素名（比如把<servlet>写成<servelt>），或者元素顺序不符合Servlet规范（比如<context-param>需放在<filter>之前）。STS的XML编辑器会用红色波浪线标记语法错误，可直接定位问题点。
• 验证web.xml版本与项目环境匹配：确认web.xml的根元素版本、命名空间和schemaLocation是否和项目使用的Servlet版本、JDK版本对应。比如Servlet 3.1要求Java 1.7+，对应的web.xml根元素配置需正确匹配。
• 检查web.xml文件是否损坏：查看文件编码是否为UTF-8，是否存在乱码或二进制内容混入。可尝试重新生成web.xml进行测试。
• 核对项目Facets配置：右键项目→Properties→Project Facets，检查Dynamic Web Module版本、Java版本是否兼容，且与web.xml的版本匹配。
• 清理STS缓存与项目：执行Project→Clean清理当前项目，同时清理STS的缓存目录，避免缓存导致的验证异常。

解决方案 #

• 修复web.xml语法错误：根据STS的提示修正标签闭合、元素拼写等问题，确保符合XML规范和Servlet部署描述符要求。
• 匹配web.xml与Servlet版本：根据项目使用的Servlet版本，更新web.xml的根元素配置。比如Servlet 4.0的标准配置：

<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd"
         version="4.0">
    <!-- 你的配置内容 -->
</web-app>

• 重新生成web.xml：右键项目→Java EE Tools→Generate Deployment Descriptor Stub，生成一个标准的空web.xml，再逐步添加自定义配置。
• 调整项目Facets：在Project Facets中，先取消勾选Dynamic Web Module和Java，应用后重新勾选并选择正确的兼容版本，比如Dynamic Web Module 3.1搭配Java 1.8。
• 清理缓存重启：关闭STS，删除工作空间下.metadata/.plugins/org.eclipse.jst.j2ee/和.metadata/.plugins/org.eclipse.wst.server.core/目录，重启STS后重新部署项目。

内容的提问来源于stack exchange，提问作者krishn murari