Spring Boot 自 2.4 版本起原生支持通过 spring.config.import 导入外部 .env 文件，无需第三方依赖即可将环境变量自动注入 application.yml，实现敏感配置与代码解耦。
spring boot 自 2.4 版本起原生支持通过 `spring.config.import` 导入外部 `.env` 文件，无需第三方依赖即可将环境变量自动注入 application.yml，实现敏感配置与代码解耦。
在微服务与容器化部署日益普及的今天，将数据库密码、API密钥等敏感信息硬编码在 application.yml 中存在严重安全风险。虽然可通过 IntelliJ 运行配置或命令行 -D 参数传入环境变量（如 ${DB_USERNAME}），但这种方式难以统一管理，且不适用于 CI/CD 流水线或 Docker 环境。幸运的是，Spring Boot 2.4+ 提供了开箱即用的解决方案：直接导入本地 .env 文件，实现类似 Docker Compose env_file 的能力。
✅ 正确配置方式（推荐）
确保你的 .env 文件位于项目根目录（即 mvn clean package 所在层级），内容格式为标准键值对（无空格、无引号更稳妥）：
# .env DB_NAME=myapp_db DB_USERNAME=postgres DB_PASSWORD=secret123
然后在 application.yml 中添加 spring.config.import 声明（注意：必须置于顶层，不可嵌套）：
# application.yml
spring:
config:
import: optional:file:.env[.properties]
datasource:
driver-class-name: org.postgresql.Driver
url: jdbc:postgresql://localhost:5432/${DB_NAME}
username: ${DB_USERNAME}
password: ${DB_PASSWORD}
? 关键说明：
- optional: 前缀表示该文件非必需，缺失时启动不报错；
- file:.env[.properties] 是 Spring Boot 的特殊语法，表示按 .properties 格式解析当前目录下的 .env 文件（YAML 解析器本身不识别 .env，此为 Spring Boot 内部转换机制）；
- 该配置必须放在 spring: 下一级，不能写在 spring.profiles.active 或其他子节点内；
- .env 文件需使用 UTF-8 编码，禁止 BOM 头。
⚠️ 注意事项与常见陷阱
- 路径必须准确：file:.env 表示相对于当前工作目录（user.dir） 的路径。若通过 IDE 启动，请检查 Run Configuration 中的 Working directory 是否为项目根目录；若打包为 JAR 运行，则需确保 .env 与 JAR 包同级，或改用绝对路径（如 file:/opt/config/.env）。
- 优先级规则：.env 导入的属性属于 PropertySource，其优先级高于 application.yml 中的同名配置，但低于命令行参数和系统环境变量，符合 Spring Boot 外部化配置优先级设计。
- 不支持嵌套结构：.env 仅支持扁平键值对（如 API_TIMEOUT=3000），不支持 YAML 的 Map/List 结构；复杂配置仍需在 application.yml 中定义。
- IDE 支持差异：IntelliJ 默认不会自动加载 .env 到运行环境，但 Spring Boot 启动时会主动读取——因此无需在 Run Configuration 中额外设置 Environment variables。
? 替代方案对比（不推荐，仅作了解）
| 方式 | 是否原生 | 安全性 | 维护性 | 适用场景 |
|---|---|---|---|---|
| @Value("${DB_USERNAME}") + 系统环境变量 | ✅（需手动设） | ⚠️ 依赖运维配置 | ❌ 易遗漏 | 临时调试 |
| 第三方库（dotenv-java） | ❌（需引入） | ✅ | ⚠️ 增加依赖 | Spring Boot |
| spring.config.location 指向外部 properties | ✅ | ✅ | ✅ | 需要完整配置文件而非仅变量 |
✅ 最佳实践总结
- 始终使用 optional:file:.env[.properties] —— 简洁、安全、无需侵入代码；
- 将 .env 加入 .gitignore，避免敏感信息泄露；
- 生产环境配合 spring.profiles.active=prod 使用独立 application-prod.yml，并在其中引用相同占位符，由运维提供对应 .env.prod；
- 验证是否生效：在任意 @Component 中注入 Environment，打印 environment.getProperty("DB_USERNAME") 即可确认。
通过这一机制，你既能享受 Docker Compose env_file 的便捷，又保持 Spring Boot 原生生态的纯粹性与可维护性。
