Springboot yml怎么获取系统环境变量的值

发布时间：2022-02-17 09:18:23 作者：iii
来源：亿速云阅读：1036

# Springboot yml怎么获取系统环境变量的值

## 引言

在现代应用开发中，**配置管理**是至关重要的一环。Spring Boot作为Java生态中最流行的框架之一，提供了强大的配置管理能力，其中`application.yml`（或`application.properties`）是默认的配置文件格式。而将系统环境变量与YAML配置结合使用，可以实现更灵活的部署方案。本文将深入探讨如何在Spring Boot的YAML配置中获取系统环境变量的值。

---

## 目录
1. [环境变量与配置的关系](#环境变量与配置的关系)
2. [YAML基础语法回顾](#yaml基础语法回顾)
3. [Spring Boot中引用环境变量](#spring-boot中引用环境变量)
   - [3.1 直接引用语法](#31-直接引用语法)
   - [3.2 默认值设置](#32-默认值设置)
   - [3.3 嵌套属性引用](#33-嵌套属性引用)
4. [操作系统环境变量设置](#操作系统环境变量设置)
   - [4.1 Linux/Mac](#41-linuxmac)
   - [4.2 Windows](#42-windows)
5. [高级用法](#高级用法)
   - [5.1 多环境配置](#51-多环境配置)
   - [5.2 自定义前缀](#52-自定义前缀)
   - [5.3 加密处理](#53-加密处理)
6. [调试与常见问题](#调试与常见问题)
7. [最佳实践](#最佳实践)
8. [总结](#总结)

---

## 环境变量与配置的关系

系统环境变量是操作系统级别的键值对存储，具有以下特点：
- **全局可见性**：所有进程均可访问
- **运行时注入**：无需修改代码即可改变应用行为
- **安全性**：敏感信息可避免硬编码

在Spring Boot中，环境变量的优先级高于`application.yml`中的配置（遵循[特定优先级规则](https://docs.spring.io/spring-boot/docs/current/reference/html/features.html#features.external-config)）。

---

## YAML基础语法回顾

YAML（YAML Ain't Markup Language）是常用的配置文件格式，比Properties文件更具可读性：

```yaml
server:
  port: 8080
  servlet:
    context-path: /api

对比Properties等效配置：

server.port=8080
server.servlet.context-path=/api

Spring Boot中引用环境变量

3.1 直接引用语法

在YAML中使用${VARIABLE_NAME}语法引用环境变量：

database:
  url: ${DB_URL}
  username: ${DB_USER}
  password: ${DB_PASSWORD}

当环境变量未设置时，启动会报错。可通过:指定默认值。

3.2 默认值设置

app:
  cache-size: ${CACHE_SIZE:100}  # 默认值100

3.3 嵌套属性引用

spring:
  datasource:
    url: jdbc:mysql://${DB_HOST:localhost}:${DB_PORT:3306}/${DB_NAME}

操作系统环境变量设置

4.1 Linux/Mac

# 临时设置
export DB_URL=jdbc:mysql://localhost:3306/mydb

# 永久设置（添加到~/.bashrc或~/.zshrc）
echo "export DB_USER=admin" >> ~/.bashrc
source ~/.bashrc

4.2 Windows

:: 临时设置
set DB_PASSWORD=secret

:: 永久设置（系统属性→高级→环境变量）

高级用法

5.1 多环境配置

结合spring.profiles.active使用：

# application-dev.yml
database:
  url: ${DEV_DB_URL}
  
# application-prod.yml  
database:
  url: ${PROD_DB_URL}

激活方式：

java -jar app.jar --spring.profiles.active=prod

5.2 自定义前缀

通过@ConfigurationProperties实现：

@Configuration
@ConfigurationProperties(prefix = "myapp")
public class AppConfig {
    private String apiKey;
    // getters & setters
}

YAML配置：

myapp:
  api-key: ${API_KEY}

5.3 加密处理

使用Jasypt等工具加密敏感数据：

database:
  password: ENC(${ENCRYPTED_DB_PASSWORD})

调试与常见问题

查看实际加载的配置：

@SpringBootApplication
public class MyApp {
    public static void main(String[] args) {
        SpringApplication.run(MyApp.class, args)
            .getEnvironment().getPropertySources().forEach(ps -> {
                System.out.println(ps.getName() + ": " + ps.getSource());
            });
    }
}

常见错误： 1. Could not resolve placeholder - 环境变量未设置且无默认值 2. 变量名大小写不匹配（Linux区分大小写） 3. 特殊字符未转义

最佳实践

敏感信息：永远不要将密码等写入版本控制
命名规范：使用大写+下划线命名环境变量（如DB_HOST）
文档化：维护config/README.md说明必需的环境变量
容器化支持：Docker/K8s中通过envFrom注入

总结

通过本文我们系统学习了： - YAML中引用环境变量的基础语法 - 多环境配置管理策略 - 实际部署时的操作系统设置 - 高级应用场景和调试技巧

掌握这些技能后，你的Spring Boot应用将获得更强的环境适应能力，实现真正的”一次构建，到处运行”。

延伸阅读： - Spring Boot Externalized Configuration - 12 Factor App Config “`

注：本文实际约2000字，可通过以下方式扩展： 1. 增加具体代码示例 2. 补充各操作系统的详细截图 3. 添加性能优化建议 4. 深入Spring Environment源码解析