Spring中ClassPathXmlApplicationContext加载XML配置文件失败求助

在Spring应用中创建Bean时，将XML配置文件加载到ClassPathXmlApplicationContext时抛出IOException，提示配置文件不存在，但实际文件已放置在类路径对应的com/satwik/spring目录下。

测试类代码 #

public class Test {

    public static void main(String[] args) {

        ApplicationContext context = new ClassPathXmlApplicationContext("com/satwik/spring/config.xml");
        Employee employee = (Employee) context.getBean("employee");
        System.out.println(employee);
    }

}

异常信息 #

at com.satwik.spring.Test.main(Test.java:11)
Caused by: java.io.FileNotFoundException: class path resource [com/satwik/spring/config.xml] cannot be opened because it does not exist
    at org.springframework.core.io.ClassPathResource.getInputStream(ClassPathResource.java:172)
    at org.springframework.beans.factory.xml.XmlBeanDefinitionReader.loadBeanDefinitions(XmlBeanDefinitionReader.java:330)
    ... 13 more
    ... 13 more

已尝试的操作 #

• 使用完整路径com/satwik/spring/config.xml加载，抛出相同异常；
• 直接使用config.xml作为路径，仍无法加载，抛出相同异常。

问题排查与解决方案 #

1. 检查资源文件的编译输出 #

Maven/Gradle等构建工具默认只会将src/main/resources目录下的文件复制到编译后的classpath（如target/classes），如果将config.xml放在src/main/java的包目录下，需要在构建配置中添加资源扫描规则：

• Maven：在pom.xml中添加

<build>
    <resources>
        <resource>
            <directory>src/main/java</directory>
            <includes>
                <include>**/*.xml</include>
            </includes>
        </resource>
        <resource>
            <directory>src/main/resources</directory>
        </resource>
    </resources>
</build>

• Gradle：在build.gradle中添加

sourceSets {
    main {
        resources {
            srcDirs = ['src/main/java', 'src/main/resources']
            includes = ['**/*.xml']
        }
    }
}

添加后重新编译项目，确认target/classes/com/satwik/spring/config.xml是否存在。

2. 确认路径大小写匹配 #

Linux/Mac系统对路径和文件名大小写敏感，检查代码中指定的路径com/satwik/spring/config.xml与实际文件的目录、文件名大小写是否完全一致，比如不要出现Config.xml和config.xml的差异。

3. 调整配置文件存放位置 #

将config.xml移动到src/main/resources/com/satwik/spring目录下，此时直接使用com/satwik/spring/config.xml作为路径即可正常加载，无需额外配置构建规则。

4. 验证classpath路径 #

可以通过打印当前classpath来确认文件是否在类路径中：

System.out.println(System.getProperty("java.class.path"));

或者使用ClassPathResource手动验证：

ClassPathResource resource = new ClassPathResource("com/satwik/spring/config.xml");
System.out.println("文件是否存在：" + resource.exists());

5. 临时使用文件系统路径测试 #

如果以上方法都无效，可以先用FileSystemXmlApplicationContext加载文件系统路径，确认文件本身没问题：

ApplicationContext context = new FileSystemXmlApplicationContext("src/main/java/com/satwik/spring/config.xml");

如果能正常加载，说明问题出在classpath配置上，回到步骤1重新检查构建配置。

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