Spring 资源与环境配置体系详解

定位：讲透 Resource 资源抽象、Environment/PropertySource 属性体系、占位符解析、Profile 机制与配置绑定概念

适用版本：Spring Framework 6.x（JDK 17+）

说明：本篇只讲解 Framework 层概念地基，SpringBoot有自身的资源文件加载机制。

一、Resource 抽象

1.1 统一资源访问

应用要访问的资源来源各异：classpath 文件、磁盘文件、URL、内存字节流、Servlet 上下文。Resource 接口把这些统一成一种抽象：

复制代码

InputStream in = resource.getInputStream();   // 无论来源是什么
boolean ok = resource.exists() && resource.isReadable();

1.2 常见实现与获取方式

实现	来源
`ClassPathResource`	classpath 下
`FileSystemResource`	文件系统
`UrlResource`	URL（http/file 等）
`ByteArrayResource`	内存字节数组
`ServletContextResource`	Web 应用上下文

按前缀自动选择实现 （ResourceLoader 的职责）：

复制代码

classpath:app.yml   → ClassPathResource
file:/opt/app.yml   → FileSystemResource
https://...         → UrlResource
（无前缀）          → 取决于上下文类型

ApplicationContext 本身就是 ResourceLoader，getResource("classpath:x") 即可。

1.3 批量解析

复制代码

Resource[] rs = resolver.getResources("classpath*:mapper/*.xml");

classpath: 只取第一个匹配，classpath*: 扫描所有 jar/目录下的匹配------MyBatis 扫描多模块 mapper、组件扫描多 jar 都靠它。

二、Environment 与 PropertySource

2.1 Environment 的两部分

复制代码

Environment
├── Profile 管理（哪些环境被激活）
└── PropertySources（属性源，有序列表）

2.2 PropertySource 与优先级

属性来自多个源，组成有序列表，按序查找、先到先得：

复制代码

典型顺序（靠前优先）：
命令行参数 > 系统属性（-D） > 操作系统环境变量
> 应用配置文件（按 Boot 规则） > 默认值

要点	说明
有序覆盖	同名属性，靠前的源生效
动态调整	`MutablePropertySources` 可增删、调序（配置中心接入靠这个）
自定义源	继承 `PropertySource` 从数据库/配置中心读属性

理解"属性源有序列表"是理解一切配置覆盖问题的钥匙------"为什么我配的值没生效"几乎都能归因到优先级。

2.3 与 Bean 的关系

Environment 在容器最早期就绪（refresh 第①②步之前），Bean 可通过注入 Environment 编程式取属性，或配合 @Profile/@ConditionalOnProperty 做条件装配（05 篇）。

三、属性解析与占位符

3.1 三种使用方式

java 复制代码

@Value("${app.name}")                  // 占位符：从属性源取值
@Value("${app.timeout:3000}")          // 带默认值
@Value("#{systemProperties['user.home']}")   // SpEL 表达式
String name = env.getProperty("app.name");   // 编程式

3.2 占位符由谁解析

${} 占位符不是容器原生能力，由 PropertySourcesPlaceholderConfigurer（一个 BeanFactoryPostProcessor）在 Bean 定义处理阶段解析。推论：

自定义的占位符处理器要注册得足够早；
${} 解析失败（无值且无默认）启动直接报错------这是配置缺失的快速失败。

3.3 @Value 与 @ConfigurationProperties 的取舍

场景	选择
单个值、表达式	@Value
一组结构化配置	@ConfigurationProperties（见第五节）

四、Profile 机制

4.1 用途

同一应用在不同环境（dev/test/prod）用不同配置与 Bean：数据源、日志级别、开关。

4.2 两个作用对象

复制代码

① 配置文件：application-{profile}.yml（Boot 层，BT-04 深讲）
② Bean/配置类：@Profile 条件装配

@Configuration
@Profile("prod")
public class ProdDataSourceConfig { ... }

4.3 激活方式

方式	示例
配置属性	`spring.profiles.active=prod`
环境变量	`SPRING_PROFILES_ACTIVE=prod`
JVM 参数	`-Dspring.profiles.active=prod`
API	`ctx.getEnvironment().setActiveProfiles("prod")`

纪律：环境差异交给 profile，不要把 if(env) 写进业务代码；生产 profile 的激活入口收敛到部署系统，避免开发机误配。

五、配置绑定基础

5.1 类型安全绑定（概念）

java 复制代码

@ConfigurationProperties(prefix = "app.datasource")
public class DataSourceProps {
    private String url;
    private int maxPoolSize;
}

把前缀下的属性批量绑定到对象------相比散落的 @Value：类型转换自动、可校验（@Validated）、可测试、IDE 可提示。

5.2 松散绑定

复制代码

配置里的 app.datasource.max-pool-size
绑定到  maxPoolSize / max_pool_size 均可

属性名在"连字符/下划线/驼峰"间宽松匹配，这是 Boot 配置体验的重要部分。

六、总结

Resource 抽象 ：统一 classpath/文件/URL/字节流的访问，按前缀自动选实现；classpath*: 批量扫描多 jar。
Environment ：Profile + PropertySources；属性源有序、先到先得，MutablePropertySources 支持动态增删调序------配置覆盖问题的分析框架。
占位符 ：${} 由 PropertySourcesPlaceholderConfigurer 解析，缺值快速失败；@Value 适合单值与 SpEL。
Profile：环境差异的正交开关，作用于配置文件与 @Profile Bean；激活收敛到部署系统。
配置绑定：结构化配置用 @ConfigurationProperties（类型安全、可校验），松散绑定提升书写体验；

七、常见高频面试题

1. Spring 的 Resource 抽象解决什么问题？有哪些常见实现？

要点：统一不同来源资源（classpath、文件系统、URL、内存字节、Web 上下文）的访问接口，屏蔽来源差异，统一提供 getInputStream/exists 等操作。常见实现：ClassPathResource、FileSystemResource、UrlResource、ByteArrayResource、ServletContextResource。通过前缀（classpath:/file: 等）由 ResourceLoader 自动选择实现；ApplicationContext 本身就是 ResourceLoader。

*2. classpath: 和 classpath: 的区别？**

要点：classpath: 只从 classpath 中取第一个匹配的资源；classpath*: 扫描所有 classpath 路径（包括各 jar 包内）的全部匹配资源并返回数组。多模块项目中扫描分散在不同 jar 的配置文件（如 MyBatis 的 mapper/.xml、各模块的扩展配置）必须用 classpath:，否则只能扫到第一个。

3. Spring 中属性（配置）的来源有哪些？优先级如何？

要点：属性来自多个 PropertySource 组成有序列表，查找时先到先得。典型优先级（靠前覆盖靠后）：命令行参数 > JVM 系统属性 > 操作系统环境变量 > 应用配置文件 > 默认属性。MutablePropertySources 支持动态增删与调整顺序，配置中心接入本质是插入一个高优先级属性源。"配置不生效"类问题应优先检查属性源优先级。

4. @Value("${}") 的占位符是谁解析的？缺失时会怎样？

要点：由 PropertySourcesPlaceholderConfigurer（BeanFactoryPostProcessor）在 Bean 定义处理阶段解析，从 Environment 的属性源取值；支持 ${key:default} 默认值语法。若属性缺失且无默认值，启动直接抛异常快速失败。另注意 @Value 作用于字段/参数注入，与 @ConfigurationProperties 的批量类型安全绑定是两条路径。

5. Environment 接口包含哪两部分？

要点：Profile 管理与属性访问。Profile 部分：获取/设置激活的 profile 与默认 profile，支撑多环境条件装配；属性部分：聚合所有 PropertySource，提供 getProperty 按优先级取值。Environment 在容器启动最早期就绪，Bean 可注入使用；它也是 @Profile、@ConditionalOnProperty 等条件注解的判定基础。

6. @Profile 是怎么工作的？有哪些激活方式？

要点：@Profile 标注在 @Component/@Configuration 上，只有指定 profile 激活时该 Bean 才注册，本质是条件装配（@Conditional 的特化）。激活方式：spring.profiles.active 属性（配置文件/环境变量 SPRING_PROFILES_ACTIVE/JVM -D 参数）或 API setActiveProfiles。实践纪律：环境差异用 profile 表达而非业务代码里的 if；生产 profile 激活入口收敛到部署系统。

7. @Value 和 @ConfigurationProperties 怎么选？

要点：@Value 注入单个属性值，支持 SpEL 表达式，适合零散配置；@ConfigurationProperties 把指定前缀下的属性批量绑定到 POJO，类型自动转换、支持松散绑定（max-pool-size ↔ maxPoolSize）、可配合 @Validated 校验、可被单元测试直接构造。一组结构化配置（如数据源、线程池参数）用后者，可读性与可维护性远胜一堆 @Value。

8. 什么是松散绑定（Relaxed Binding）？

要点：@ConfigurationProperties 绑定时，配置键与属性名在书写风格上宽松匹配：kebab-case（max-pool-size）、下划线（max_pool_size）、驼峰（maxPoolSize）、大写（MAX_POOL_SIZE）可互相对应。这让配置文件可用规范的连字符风格而 Java 侧保持驼峰。注意 @Value 不支持松散绑定，这是它与类型安全绑定的差异之一。

9. 自定义属性源（如从配置中心读配置）怎么接入？

要点：实现 PropertySource 抽象类（定义 getName 与 getProperty），在容器启动早期（如 ApplicationContextInitializer 或 EnvironmentPostProcessor）把它加入 Environment 的 MutablePropertySources；通过 addFirst/addBefore 控制优先级，使配置中心的值能覆盖本地文件。Boot 的配置中心整合（如 Spring Cloud Config/Nacos）本质就是这个机制。

10. 为什么"我配置的属性没有生效"？给出排查思路。

要点：按属性源优先级排查------① 是否有更高优先级的源覆盖了它（命令行/-D/环境变量/其他配置文件）；② profile 是否匹配（application-{profile}.yml 与激活 profile 不一致）；③ 属性名拼写与绑定风格（@Value 不支持松散绑定）；④ 占位符默认值掩盖了缺失（${k:def} 一直用默认）；⑤ 配置类是否被加载（@Configuration 生效、组件扫描范围）。用 Actuator 的 env 端点或调试打印 PropertySources 顺序可直观定位。