Spring 配置文件加载路径：classpath、file、URL 与 Web 容器路径

优质文章学习记录

06 Apr 2026 — 5 min read

在 Spring 框架中，ApplicationContext 在启动时需要加载配置文件（如 XML 配置或其他资源文件），而这些配置文件可能位于 不同的位置。
Spring 为此提供了统一的资源加载机制（Resource Loader），使应用程序可以从 类路径、文件系统、网络地址或 Web 容器路径 等不同来源读取配置。

常见的配置加载路径主要包括：

Classpath（类路径）
File System（文件系统路径）
URL（网络资源路径）
ServletContext（Web 容器路径）
classpath*（通配符类路径）

不同路径适用于不同的项目环境和部署方式。

一、Classpath 路径

1.1 什么是Classpath 路径

Classpath 指的是 Java 类路径（ClassPath）中的资源位置。
在 Maven 或 Gradle 项目中，classpath 通常包括：

src/main/resources
target/classes
项目依赖的 jar 包

当 Spring 从 classpath 加载配置文件时，实际上是从 Java 运行时的类路径中查找资源。

例如：

ApplicationContext context = new ClassPathXmlApplicationContext("applicationContext.xml");

或者：

classpath:applicationContext.xml

如果配置文件位于：

src/main/resources/applicationContext.xml

项目编译后会被复制到：

target/classes/applicationContext.xml

1.2 适用场景

classpath 是 最常见的配置加载方式，适用于：

Spring Boot 项目
Maven / Gradle 项目
配置文件需要随应用一起打包
jar 包独立运行的场景

例如 Spring Boot 项目通常使用：

application.yml application.properties

这些配置文件通常都位于 classpath 中。

这种方式的优点是：

项目结构清晰
配置随应用发布
部署简单

但缺点是 配置文件无法在运行时直接修改，如果需要修改配置，通常需要重新打包或重启应用。

二、文件系统路径（File System）

2.1 什么是文件系统路径

文件系统路径是指 操作系统中的真实文件路径，Spring 可以直接从磁盘读取配置文件。

例如：

ApplicationContext context = new FileSystemXmlApplicationContext( "D:/config/applicationContext.xml" );

或者：

file:/opt/config/applicationContext.xml

这里的路径指向操作系统中的文件，而不是项目内部资源。

例如 Linux 服务器：

/opt/config/applicationContext.xml

Windows：

D:/config/applicationContext.xml

2.2 适用场景

文件系统路径通常用于 外部配置管理，适合以下情况：

1 生产环境配置

在生产环境中，通常不希望配置文件打包进 jar 中，而是单独放在服务器目录，例如：

/opt/app/config/application.yml

这样应用升级时不需要修改配置文件。

2 多环境配置

在不同环境中，配置文件往往不同，例如：

dev 环境 test 环境 prod 环境

可以通过不同路径加载不同配置。

3 动态修改配置

如果配置在 jar 内部：

app.jar ├─ application.yml

则无法直接修改。

但如果配置在外部：

/config/application.yml

就可以直接编辑。

三、URL 路径

3.1 什么是URL路径

URL路径（URL Path）是指 URL 中用于定位服务器上具体资源或接口位置的部分，用于表示客户端请求访问的具体资源路径。

Spring 也支持从 URL 地址加载配置文件。

例如：

https://example.com/applicationContext.xml

在代码中可以这样使用：

ApplicationContext context = new ClassPathXmlApplicationContext( "https://example.com/config.xml" );

Spring 会通过 HTTP 请求获取配置文件。

3.2 适用场景

URL 加载方式一般用于：

分布式系统
配置中心
远程配置管理

例如：

Apollo Nacos Spring Cloud Config

这些配置中心本质上也是 远程加载配置文件。

不过在传统 Spring 项目中直接使用 URL 加载配置较少见。

四、ServletContext 路径（Web 项目）

4.1 什么是ServletContext 路径

ServletContext 路径（Context Path）是指 Web 应用在服务器中的访问根路径，用于标识当前应用在服务器中的唯一访问入口。

如果项目是 Web 应用（Spring MVC），Spring 还可以从 Web 容器路径加载配置。

例如：

/WEB-INF/applicationContext.xml

该路径属于 Web 容器内部资源。

在 web.xml 中通常这样配置：

<context-param> <param-name>contextConfigLocation</param-name> <param-value>/WEB-INF/applicationContext.xml</param-value> </context-param>

Spring 在 Web 容器启动时会读取该配置。

4.2 适用场景

这种方式主要用于：

传统 Spring MVC 项目
Tomcat / Jetty 等 Web 容器
Web 应用初始化配置

在 Spring Boot 中这种方式已经较少使用。

五、classpath* 通配符路径

5.1 什么是classpath* 通配符路径

classpath* 通配符路径表示从 所有 classpath 位置中搜索并加载匹配的资源文件，通常用于在多个 jar 包或目录中查找同名配置文件。

Spring 提供了 classpath* 语法，用于扫描多个配置文件。

例如：

classpath*:spring/*.xml

示例：

ApplicationContext context = new ClassPathXmlApplicationContext( "classpath*:spring/*.xml" );

Spring 会在 所有 classpath 位置中查找匹配文件。

例如：

spring-dao.xml spring-service.xml spring-web.xml

这些文件都会被加载。

5.2 适用场景

适用于：

模块化项目
大型系统拆分配置
自动扫描配置文件

六、几种路径方式总结

Spring 提供了统一的资源加载机制，使应用程序能够从不同位置读取配置文件。常见的资源路径包括 classpath、file、URL、ServletContext 以及 classpath* 等。

其中：

classpath 适合项目内部配置
file 适合生产环境外部配置
URL 适合远程配置管理
ServletContext 主要用于 Web 项目
classpath* 用于批量加载配置

在实际开发中，最常见的方式仍然是 classpath 加载配置文件，而在生产环境中通常会结合 file 路径进行外部配置管理，以提高系统的灵活性和可维护性。