Tomcat启动异常：ApplicationContext出现意外contextConfigLocation=<NONE>参数

以下是几个优先级从高到低的排查点：

• 检查IntelliJ的Tomcat运行配置
  打开Run/Debug Configurations找到你的Tomcat实例：

  1. 切换到「Deployment」标签，查看是否有额外添加的上下文参数；
  2. 切换到「VM options」栏，检查是否存在 -DcontextConfigLocation=<NONE> 这类启动参数；
  3. 查看「Configuration」标签下的部署设置，确认是否勾选了自动生成配置的选项，导致IDE自动注入了该参数。

• 排查Tomcat的全局/本地配置文件

  1. 打开你使用的Tomcat实例的 conf/web.xml（全局web配置文件），搜索是否有 <context-param> 节点定义了 contextConfigLocation 为 <NONE>；
  2. 检查项目根目录下的 META-INF/context.xml，或是Tomcat实例的 conf/context.xml，看是否存在 <Parameter> 标签设置了该参数。

• 检查依赖jar包中的web-fragment.xml
  部分第三方框架的jar包会通过 web-fragment.xml 向应用注入上下文参数：

  1. 在IntelliJ中展开「External Libraries」，逐个查看jar包内是否包含 META-INF/web-fragment.xml；
  2. 搜索这些片段文件，确认是否存在 contextConfigLocation 的相关配置。

• 核查构建脚本的动态配置
  如果使用Maven或Gradle构建项目：

  1. Maven：查看 pom.xml 中 maven-war-plugin 的配置，检查是否有 webResources 节点在打包时修改web.xml或注入参数；
  2. Gradle：查看 build.gradle 里 war 任务的配置，确认是否存在动态注入上下文参数的逻辑。

• 清理IDE缓存并重新构建
  有时IntelliJ的缓存会引发配置异常：

  1. 执行 File -> Invalidate Caches...，勾选「Clear file system cache and local history」后重启IDE；
  2. 执行 mvn clean install（Maven）或 gradle clean build（Gradle），重新构建项目后再启动Tomcat。

另外对比正常服务时，除了web.xml，还要注意：

• 两者使用的Tomcat实例是否一致（全局配置可能不同）；
• 依赖jar包的版本是否完全匹配；
• IntelliJ的运行配置是否存在差异。

内容的提问来源于stack exchange，提问作者Greg Burcher