趴在黄油上1. 为什么需要读取Windows环境变量？
在SpringBoot项目中，我们经常遇到这样的场景：开发环境、测试环境和生产环境需要不同的配置参数。比如数据库连接字符串、API密钥、文件存储路径等。直接在yml文件中硬编码这些敏感信息显然不安全，也不利于多环境部署。
Windows环境变量提供了一种优雅的解决方案。通过将配置值存储在系统环境变量中，我们可以：
- 保护敏感信息不被直接暴露在代码仓库中
- 实现一套代码在不同环境中的无缝切换
- 避免每次部署时手动修改配置文件
- 方便运维人员在不接触代码的情况下调整配置
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. SpringBoot配置文件的优先级机制
SpringBoot遵循特定的配置加载顺序，理解这一点对正确使用环境变量至关重要：
2.1 默认加载顺序
- 命令行参数（最高优先级）
- JNDI属性
- Java系统属性（System.getProperties()）
- 操作系统环境变量
- 打包在jar包外的配置文件（application-{profile}.properties/yml）
- 打包在jar包内的配置文件
- @PropertySource注解指定的文件
- 默认属性（通过SpringApplication.setDefaultProperties设置）
2.2 环境变量的特殊处理
SpringBoot会自动将环境变量名转换为适合属性源的格式：
- 将下划线(_)替换为点(.)
- 将大写字母转换为小写
- 例如：
DATABASE_URL→database.url
3. 在yml中使用环境变量的具体方法
3.1 基础语法
在application.yml中引用环境变量的标准格式：
yaml复制custom:
app:
database-url: ${DATABASE_URL}
max-pool-size: ${DB_MAX_POOL_SIZE:10} # 带默认值
3.2 Windows环境变量设置
- 打开系统属性 → 高级 → 环境变量
- 在"用户变量"或"系统变量"中添加新变量
- 变量名建议使用大写+下划线命名法（如
APP_SECRET_KEY） - 重启IDE或命令行窗口使变量生效
3.3 验证环境变量是否生效
在SpringBoot应用中添加测试端点：
java复制@RestController
public class EnvCheckController {
@GetMapping("/env-check")
public String checkEnv(@Value("${custom.app.database-url}") String dbUrl) {
return "Database URL from env: " + dbUrl;
}
}
4. 高级用法与实战技巧
4.1 多环境配置组合
结合Spring Profiles实现环境隔离：
yaml复制# application-dev.yml
spring:
profiles: dev
custom:
app:
env-specific-setting: ${DEV_SPECIFIC_SETTING}
# application-prod.yml
spring:
profiles: prod
custom:
app:
env-specific-setting: ${PROD_SPECIFIC_SETTING}
4.2 敏感信息加密
对于特别敏感的环境变量，建议结合加密方案：
- 使用Jasypt等库加密值
- 将加密后的值存入环境变量
- 在配置中解密：
yaml复制custom:
encrypted-value: ENC(${ENCRYPTED_ENV_VAR})
4.3 环境变量命名规范建议
- 使用应用前缀避免冲突：
MYAPP_DB_URL优于DB_URL - 区分环境：
DEV_DB_URL/PROD_DB_URL - 保持一致性：全团队遵循同一命名约定
5. 常见问题排查
5.1 环境变量未生效的可能原因
- 变量名拼写错误（注意大小写敏感）
- 未重启IDE/终端导致新变量未加载
- 作用域问题（用户变量 vs 系统变量）
- 被更高优先级的配置覆盖
5.2 调试技巧
- 打印所有环境变量：
java复制System.getenv().forEach((k,v) -> System.out.println(k + "=" + v));
- 检查SpringBoot的解析结果：
bash复制java -jar your-app.jar --debug
5.3 特殊字符处理
当环境变量值包含特殊字符（如@,#,$）时：
- 在Windows中，用双引号包裹变量值
- 在yml中使用单引号：
yaml复制password: '${DB_PASSWORD_WITH_SPECIAL_CHARS}'
6. 最佳实践与安全建议
-
敏感信息管理：
- 永远不要将含敏感信息的配置文件提交到版本控制
- 使用
.gitignore排除本地配置文件 - 考虑使用Vault等专业密钥管理工具
-
文档规范：
- 维护
env-template.yml文件列出所有需要的环境变量 - 为新成员提供清晰的配置说明文档
- 维护
-
容器化部署适配：
- Docker中通过
-e参数传递环境变量 - Kubernetes中使用ConfigMap和Secret
- Docker中通过
-
开发团队协作：
- 共享开发环境变量配置（通过安全渠道）
- 使用
.env文件配合spring-dotenv等库（仅限开发环境）
-
监控与审计：
- 记录配置加载过程（不记录敏感值）
- 定期审查环境变量使用情况
在实际项目中，我遇到过环境变量因Windows更新被意外重置的情况。建议在关键部署前验证所有必需变量是否存在，可以编写启动检查脚本：
java复制@PostConstruct
public void validateEnvironment() {
List<String> requiredVars = Arrays.asList("DB_URL", "API_KEY");
requiredVars.forEach(var -> {
if (System.getenv(var) == null) {
throw new IllegalStateException("Missing required environment variable: " + var);
}
});
}
对于大型项目，可以考虑实现配置中心动态加载，但环境变量仍然是基础且可靠的配置来源。掌握好这些技巧，你的SpringBoot应用将获得更安全、更灵活的配置管理能力。