IDEA启动Spring项目报JPA命名空间处理器缺失但Eclipse正常启动的原因

问题根因与解决方案 #

你遇到的核心报错翻译如下：

org.springframework.beans.factory.parsing.BeanDefinitionParsingException: 配置问题：无法找到XML schema命名空间 [http://www.springframework.org/schema/data/jpa] 对应的Spring NamespaceHandler
异常涉及资源：URL [jar:file:/D:/mavens/repository/com/ygsoft/necp/component/necp.component.unstructure/7.1.0.ecp/necp.component.unstructure-7.1.0.ecp.jar!/META-INF/ecp-spring/ecp.unstructure.xml]

同项目Eclipse可正常启动、IDEA启动失败，按优先级依次排查以下问题即可解决：

• Maven配置不一致
  进入IDEA设置页 Settings -> Build,Execution,Deployment -> Build Tools -> Maven，确认使用的settings.xml、本地仓库路径和Eclipse完全一致。修改配置后右键项目选择 Maven -> Reload project 重新同步依赖。
• spring-data-jpa依赖缺失或损坏
  检查项目pom.xml是否已引入spring-data-jpa依赖，若已引入可删除本地仓库中org/springframework/data/spring-data-jpa对应的目录，再重新执行Maven同步，让IDEA重新拉取完整jar包。
• 运行时类路径缺失依赖
  打开IDEA右上角的项目启动配置，在Modify options中勾选Add dependencies with "provided" scope to classpath，避免scope为provided的依赖未被加载到运行时类路径。
• Spring配置文件合并冲突
  若项目使用maven-assembly-plugin或maven-shade-plugin打fatjar，需要在插件配置中添加合并规则，合并所有jar包下META-INF/spring.handlers、META-INF/spring.schemas文件。Eclipse默认类加载机制会加载所有jar包的对应配置，IDEA打包运行时如果没有合并配置，会导致后续jar的配置覆盖前面的内容，丢失对应命名空间的处理器声明。
• IDEA缓存损坏
  点击IDEA左上角 File -> Invalidate Caches...，勾选清除文件系统缓存和本地历史，重启IDEA后重新同步依赖再启动即可。

内容的提问来源于stack exchange，提问作者ivan long