spring boot yaml中引用环境变量需用${var_name}语法，依赖spring配置加载器动态替换；原生yaml不支持变量插值，环境变量须在jvm启动时可见，否则占位符不解析。

在 yaml 文件中引用环境变量，主要靠 spring boot 的 ${var_name} 占位符语法（适用于 spring boot 项目），或借助外部工具如 docker、kubernetes、ansible 等做运行时替换。原生 yaml 规范本身不支持变量插值，所以“引用环境变量”本质上是靠解析器（如 spring boot 的配置加载器）在读取时动态替换。

Spring Boot 中的 ${} 引用方式

这是最常见场景。Spring Boot 启动时会自动从系统环境变量、JVM 参数、application.properties/yml 中读取并替换 ${...} 表达式。

• YAML 中直接写：database.url: ${DATABASE_URL:jdbc:h2:mem:testdb}，冒号后为默认值（可选）
• 环境变量名建议全大写+下划线（如 DATABASE_USER），Spring Boot 默认会把 database.user 映射到 DATABASE_USER
• 支持嵌套引用：spring.profiles.active: ${PROFILE:dev}，再用 ${PROFILE} 值去加载对应 profile 配置

非 Spring 项目：需配合外部工具

纯 YAML（如 Docker Compose、K8s manifest、CI 脚本）不解析 ${}，需用工具预处理：

minimax-mcp-docker版（适配极空间）

MiniMax 图片理解 + 网络搜索 MCP 工具。适配 Docker 环境（极空间等），支持图片 OCR 识别、图像内容理解、网络搜索。API Key 安全存储在本地 credentials 文件，不暴露在代码中。

下载

• Docker Compose：使用 ${VAR_NAME}（双美元符 $$ 转义字面量），依赖 shell 展开，启动前由 compose 读取宿主机环境变量替换
• Kubernetes ConfigMap/Secret：通常用 envFrom 或 valueFrom 挂载环境变量，YAML 里不直接写变量引用；若用 Helm，则用 {{ .Values.db.host }}
• Shell + sed / envsubst：先写带占位符的模板 YAML（如 url: __DB_URL__），再用 envsubst config.yml 替换（需导出变量且变量名匹配）

注意事项与常见问题

避免踩坑的关键细节：

• Spring Boot 中，${} 只在配置属性值中生效，不能用于 key 名（如 ${ENV}.port: 8080 会报错）
• 若环境变量含特殊字符（如斜杠、冒号），建议用单引号包裹值：auth.token: '${AUTH_TOKEN}'，防止 YAML 解析异常
• 优先级顺序：命令行参数 > 系统属性 > 环境变量 > jar 包外配置 > jar 包内配置，环境变量可能被更高优先级覆盖
• 本地测试时，可通过 export DATABASE_URL=xxx 设置，或 IDE 运行配置中添加 Environment variables

验证是否生效的小技巧

快速确认变量是否被正确加载：

• Spring Boot 应用启动日志里搜索 “The following profiles are active”，或看 “Loading XML bean definitions” 类提示
• 加 @ConfigurationProperties 类并开启 @EnableConfigurationProperties，启动时报错常因变量未设置或类型不匹配
• 访问 /actuator/env（需启用 actuator）查看所有已解析的环境属性，搜索你的变量名