Spring部署JBoss时出现cvc-elt.1: beans元素声明未找到错误

这个问题我之前帮不少开发者排查过，核心是JBoss EAP 6.4的类加载机制和你的Spring应用打包/运行方式冲突导致的——单独运行fat jar时，应用会用自己打包的Spring库；但嵌入EAR部署到JBoss后，容器自带的低版本Spring库会优先被加载，进而导致Spring XML的XSD解析失败。下面给你几个针对性的解决办法：

1. 配置JBoss类加载隔离，排除容器自带的Spring库 #

JBoss EAP 6.4本身内置了Spring相关模块，当你的EAR部署时，容器类加载器会优先用这些内置版本，而不是你fat jar里的Spring 5.1.9。你需要创建一个jboss-deployment-structure.xml文件放到EAR的META-INF目录下，强制JBoss使用你打包的Spring库：

<?xml version="1.0" encoding="UTF-8"?>
<jboss-deployment-structure>
    <deployment>
        <exclusions>
            <module name="org.springframework" />
            <module name="org.springframework.spring-core" />
            <module name="org.springframework.spring-beans" />
            <module name="org.springframework.spring-context" />
            <module name="org.springframework.spring-tx" />
            <module name="org.springframework.spring-jdbc" />
        </exclusions>
    </deployment>
</jboss-deployment-structure>

2. 更换打包插件，确保Spring XSD文件正确打包 #

maven-assembly-plugin在处理Spring的schema资源文件时偶尔会出问题，比如丢失spring.schemas配置文件或者XSD本身。建议换成maven-shade-plugin，它能更好地合并Spring的资源文件，避免解析错误：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-shade-plugin</artifactId>
    <version>3.2.4</version>
    <executions>
        <execution>
            <phase>package</phase>
            <goals>
                <goal>shade</goal>
            </goals>
            <configuration>
                <transformers>
                    <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
                        <mainClass>panacea.boot.Class1</mainClass>
                    </transformer>
                    <!-- 合并Spring的schema映射文件，保证XSD路径正确 -->
                    <transformer implementation="org.apache.maven.plugins.shade.resource.AppendingTransformer">
                        <resource>META-INF/spring.schemas</resource>
                    </transformer>
                </transformers>
            </configuration>
        </execution>
    </executions>
</plugin>

打包完成后可以解压fat jar，检查org/springframework/schema/beans/等目录下是否有对应的XSD文件，以及META-INF/spring.schemas里是否包含正确的URL映射。

3. 优化Spring上下文加载逻辑 #

你的代码每次调用method1()都会创建新的ClassPathXmlApplicationContext，这不仅浪费资源，还可能在容器环境下引发类加载冲突。建议改成单例加载：

public class Class1 {
    // 全局单例上下文，只初始化一次
    private static final ApplicationContext ctx;

    static {
        try {
            ctx = new ClassPathXmlApplicationContext("applicationContext.xml");
        } catch (Exception e) {
            e.printStackTrace();
            throw new RuntimeException("Failed to initialize Spring context", e);
        }
    }

    public void method1() {
        try {
            CommonTranMan c = ctx.getBean(CommonTranMan.class);
            returnDto = c.callUpdateValues(_dtoobject);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

如果你的调用方也是Spring应用，更推荐通过依赖注入获取CommonTranMan，而不是手动加载上下文。

4. 验证Spring版本与JBoss的兼容性 #

Spring 5.1.x和JBoss EAP 6.4的兼容性不算完美，因为JBoss默认支持的是Spring 3.x版本。如果上面的方法解决后还有其他问题，可以考虑降级到Spring 4.x（比如4.3.x系列），它和JBoss EAP 6.4的适配性会更好。

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