Spring通过@Value读取外部属性文件的核心是确保Environment已加载配置：默认只加载application.properties/yml；自定义文件需用@PropertySource显式引入，支持classpath:/file:路径、ignoreResourceNotFound容错及UTF-8编码；@Value在Spring管理Bean中注入${key:default}值，推荐设默认值防启动失败，敏感信息应外置；结构化配置应改用@ConfigurationProperties。
Spring 通过 @Value 注解读取外部属性文件，核心是让 Spring 的 Environment 能访问到对应配置项。它本身不加载文件，只负责解析占位符——所以“读取外部文件”这一步必须提前完成。
确保外部配置文件被 Spring 加载
Spring Boot 默认只加载 application.properties 或 application.yml。如果要用自定义文件（如 db.properties、api.conf），必须显式引入：
- 在启动类或配置类上加
@PropertySource("classpath:db.properties") - 支持多个文件：
@PropertySource({"classpath:a.properties", "classpath:b.properties"}) - 若文件可能不存在，加上
ignoreResourceNotFound = true避免启动失败 - 路径前缀可选
classpath:（资源目录）、file:（绝对/相对路径）
在 Bean 中用 @Value 正确注入值
字段必须位于 Spring 管理的 Bean 内（如 @Component、@Service、@Configuration 类中），且不能是 static 或 final：
- 基础写法：
@Value("${database.url}") private String url; - 带默认值（强烈推荐）：
@Value("${cache.ttl:600}") private int ttl;（未配置时用 600） - 设为 null（明确表示该值必须外部提供）：
@Value("${secret.key:#{null}}") private String key; - 布尔值注意写法：
@Value("${feature.switch:false}")→ 写"false"字符串会导致转成true，应直接写false
处理常见问题
不加默认值、文件没加载、key 拼错，都会导致启动报 IllegalArgumentException: Could not resolve placeholder：
立即学习“Java免费学习笔记（深入）”；
- 检查配置文件编码是否为 UTF-8（尤其含中文时，避免乱码导致 key 匹配失败）
- 确认 profile 是否激活：若配置在
application-dev.properties，需设置spring.profiles.active=dev - 启用松散绑定后，
my-service.url可匹配my_service_url或MY_SERVICE_URL，无需严格一致 - 敏感信息（如密码）不要硬编码在配置文件里，应通过环境变量、JVM 参数或 Secret 管理工具注入
什么时候不该用 @Value
它适合单个、简单、零散的配置；但遇到以下情况，应换用 @ConfigurationProperties：
- 一组相关配置（如整个 Redis 连接参数）
- 需要类型安全校验（如
@Min(1)、@NotBlank） - 要支持 IDE 自动提示或文档生成
- 配置结构较复杂（嵌套对象、List、Map）
