Spring+Jetty项目Ant打包Jar启动报错：无法找到NamespaceHandler

API 探路者

2026-5-28

解决Spring+Jetty项目Ant打包后启动无法找到Context NamespaceHandler的问题

嘿，这个问题我之前踩过好几次坑，本质是Ant打包过程中没正确处理Spring的命名空间注册文件导致的——本地IDE跑起来正常是因为它会自动帮你加载所有依赖jar里的配置，但Ant打包时如果没做特殊处理，这些关键的注册信息要么丢失要么被覆盖，Spring自然找不到context对应的处理器。

问题根源

Spring的context命名空间对应的NamespaceHandler，是通过每个Spring模块jar里的META-INF/spring.handlers文件注册的；同时spring.schemas文件负责关联命名空间URL和对应的XSD文件。当你用Ant打包时，如果只是简单把依赖jar的内容解压合并，或者没把这些文件合并起来，就会导致只有最后一个被处理的jar的配置保留，其他的全被覆盖，这就出现了启动时的报错。

具体解决方案

1. 先确认依赖jar是否齐全

首先检查你的lib目录里有没有Spring Context相关的核心jar：

spring-context.jar（必须有，这是context命名空间的核心依赖）
spring-beans.jar、spring-core.jar这些基础依赖也不能少
同时要确保Ant脚本里把这些jar都正确纳入了打包流程——不管是合并到最终jar里，还是在Manifest的Class-Path里指定。

2. 合并META-INF下的spring.handlers和spring.schemas（关键步骤）

你需要在Ant脚本里添加任务，把所有依赖jar里的这两个文件合并成一个，避免被覆盖。比如在打包前加入以下Ant任务：

<!-- 创建临时目录存放合并后的配置文件 -->
<mkdir dir="${build.dir}/META-INF"/>

<!-- 合并所有依赖jar中的spring.handlers -->
<concat destfile="${build.dir}/META-INF/spring.handlers" fixlastline="true">
  <resources>
    <zipfileset dir="${lib.dir}" includes="**/spring.handlers"/>
  </resources>
</concat>

<!-- 合并所有依赖jar中的spring.schemas -->
<concat destfile="${build.dir}/META-INF/spring.schemas" fixlastline="true">
  <resources>
    <zipfileset dir="${lib.dir}" includes="**/spring.schemas"/>
  </resources>
</concat>

然后在打包jar的时候，把这个${build.dir}/META-INF目录下的合并文件包含进去，确保最终的erpcore.jar里的META-INF目录有这两个合并后的文件。

3. 配置正确的Manifest文件

如果你的项目是把依赖jar放在外部lib目录下，没有合并到最终jar里，那一定要在Manifest里正确设置Class-Path，让JVM能找到这些依赖：

<manifest file="${build.dir}/MANIFEST.MF">
  <attribute name="Main-Class" value="你的主类全路径"/>
  <attribute name="Class-Path" value="lib/spring-core.jar lib/spring-context.jar lib/spring-beans.jar ..."/>
</manifest>

注意这里的路径是相对于erpcore.jar的位置，所以如果lib目录和jar在同一级，这样写就没问题。

4. 验证打包结果

最后解压erpcore.jar检查几个关键点：

确认src/resources下的root-servlet.xml已经被正确打包到jar里（通常在WEB-INF/classes或者根目录）
打开META-INF/spring.handlers，里面是否包含这一行：http\://www.springframework.org/schema/context=org.springframework.context.config.ContextNamespaceHandler
检查META-INF/spring.schemas里是否有context命名空间对应的XSD配置

按这几步操作，应该就能解决启动时找不到NamespaceHandler的问题了。

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