Gradle多模块项目中跨模块引用Spring Bean XML的实现方案

核心问题分析 #

主模块找不到共享模块中的XML文件，本质是Spring配置文件的路径引用方式错误，或者共享模块的资源文件未正确打包到类路径中。以下是具体解决办法：

1. 修正XML中的类路径引用 #

将主模块applicationContext.xml中对两个XML的引用，改为类路径绝对路径（必须带classpath:前缀）：

原同模块引用可能是相对路径（如orch.one.di.xml），跨模块后必须明确从类路径加载，因为目标XML在依赖Jar的类路径下。

示例修改：

<!-- 主模块applicationContext.xml中的引用 -->
<import resource="classpath:orch.one.di.xml"/>
<import resource="classpath:clientproxy.one.di.xml"/>

• 如果共享模块的XML放在src/main/resources的子目录（如config），则路径改为classpath:config/orch.one.di.xml。

2. 确保共享模块的资源文件正确打包 #

检查共享模块:source:java:myapproot:myapp-shared-resxex的build.gradle配置，确保资源文件被纳入Jar包：

• 默认情况下，src/main/resources下的文件会自动打包，若XML放在自定义目录，需手动配置sourceSets：

sourceSets {
    main {
        resources {
            srcDirs = ['src/main/resources', 'src/main/custom-resources'] // 替换为你的自定义资源目录
        }
    }
}

• 执行gradle clean build重新构建所有模块，确保共享模块的Jar包含最新的XML文件。

3. 显式在启动代码中加载所有配置文件 #

如果XML引用仍有问题，可以绕过XML中的<import>，直接在主应用的启动代码中指定所有需要的配置文件：

// 主模块启动类中的代码
ApplicationContext context = new ClassPathXmlApplicationContext(
    "classpath:applicationContext.xml",
    "classpath:orch.one.di.xml",
    "classpath:clientproxy.one.di.xml"
);

这种方式更直观，能明确控制所有加载的配置文件。

4. 排查验证步骤 #

• 解压共享模块的Jar包，用命令jar tf myapp-shared-resxex-*.jar查看XML文件是否存在，且路径与引用一致。
• 检查主模块的依赖配置，确保是implementation而非compileOnly（compileOnly不会把依赖Jar打包到运行时类路径）：

// 主模块build.gradle中的依赖
implementation project(':source:java:myapproot:myapp-shared-resxex')

• 用gradle dependencies命令确认主模块已正确引入共享模块的依赖。

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