Spring Boot 环境变量配置详解从 IDEA 到 Docker 部署文章目录Spring Boot 环境变量配置详解从 IDEA 到 Docker 部署一、问题背景1.1 环境二、问题分析2.1 现象描述2.2 根本原因1. Spring Boot RelaxedBinding 机制2. Linux 环境变量大小写敏感3. 为什么 ${profile} 可以工作4. 为什么 ${datasource_addr} 可能失败三、IDEA Spring Boot 启动配置详解3.1 Active Profiles激活配置文件3.2 Environment Variables环境变量3.3 VM Options虚拟机参数3.4 Program Arguments程序参数3.5 参数优先级顺序四、Docker 部署最佳实践4.1 环境变量命名规范4.2 Docker 环境变量传递方式方式一docker run -e 参数方式二docker-compose.yml方式三env_file方式四CMD 参数传递4.3 配置文件最佳实践五、问题排查清单六、总结一、问题背景在 Spring Boot 项目开发中我们经常使用配置文件中的占位符来引用环境变量例如url:jdbc:mysql://${datasource_addr:10.xxx.xxx.xxx:5236}/mydb然而一个常见的问题是同样的配置在 IDEA 中运行正常但部署到 Docker 的 Linux 环境后却无法读取环境变量。本文将深入分析这个问题的原因并介绍 IDEA 中 Spring Boot 的启动配置参数帮助开发者更好地理解和解决环境变量配置问题。1.1 环境jdk 17springboot 3.4二、问题分析2.1 现象描述环境配置方式结果IDEA进程传参Program Arguments✅ 正常读取Docker Linux系统环境变量-e 参数❌ 读取失败2.2 根本原因1. Spring Boot RelaxedBinding 机制Spring Boot 提供了 RelaxedBinding宽松绑定机制允许属性名以多种形式映射datasource_addr → datasource.addr → DATASOURCE_ADDR → datasource-addr但这个机制在不同阶段有不同的表现阶段RelaxedBinding 状态说明启动初期完全生效spring.profiles.active等核心属性Bean 初始化阶段部分生效数据源等组件初始化时2. Linux 环境变量大小写敏感Windows环境变量不区分大小写profile和PROFILE等价Linux环境变量严格区分大小写profile和PROFILE是不同的变量3. 为什么${profile}可以工作spring:profiles.active:${profile:default}profile在 Spring Boot 启动的最早期被解析此时 RelaxedBinding 机制完全生效Spring 会自动尝试PROFILE、profile等多种形式4. 为什么${datasource_addr}可能失败url:jdbc:mysql://${datasource_addr:10.xxx.xxx.xxx:5236}/mydbdatasource_addr在数据源初始化阶段被解析此时 RelaxedBinding 可能不完全生效下划线_在不同环境下的处理方式不同Linux 环境下需要使用大写形式DATASOURCE_ADDR三、IDEA Spring Boot 启动配置详解在 IDEA 中运行 Spring Boot 应用时可以通过以下几种方式配置参数3.1 Active Profiles激活配置文件用途指定激活的 Spring Profile配置方式在 Run/Debug Configurations 中设置Active profiles多个 profile 用逗号分隔等效参数--spring.profiles.activedev,test示例Active profiles: xprd3.2 Environment Variables环境变量用途设置进程级别的环境变量配置方式在 Run/Debug Configurations 中设置Environment variables格式KEYVALUE多个用分号分隔示例DATASOURCE_ADDR10.xxx.xxx.xxx:5236 PROFILExprd特点在所有操作系统上行为一致Spring Boot 会自动读取这些环境变量RelaxedBinding 机制完全生效3.3 VM Options虚拟机参数用途传递 JVM 参数或系统属性配置方式在 Run/Debug Configurations 中设置VM options系统属性格式-Dpropertyvalue示例-Dspring.profiles.activexprd-Ddatasource_addr10.xxx.xxx.xxx:5236-Xms512m-Xmx1024m特点通过System.getProperty()获取优先级高于环境变量适合传递 JVM 配置参数3.4 Program Arguments程序参数用途传递命令行参数配置方式在 Run/Debug Configurations 中设置Program arguments格式--keyvalue或keyvalue示例--spring.profiles.activexprd--datasource_addr10.xxx.xxx.xxx:5236特点Spring Boot 自动解析--keyvalue格式优先级最高适合覆盖配置文件中的属性3.5 参数优先级顺序从高到低Program Arguments程序参数VM Options系统属性Environment Variables环境变量application-{profile}.yml配置文件application.yml默认配置四、Docker 部署最佳实践4.1 环境变量命名规范推荐做法使用大写字母 下划线# ✅ 推荐DATASOURCE_ADDR10.xxx.xxx.xxx:5236SPRING_PROFILES_ACTIVExprd# ❌ 不推荐datasource_addr10.xxx.xxx.xxx:5236spring.profiles.activexprd4.2 Docker 环境变量传递方式方式一docker run -e 参数dockerrun-d\--namemyapp\-eDATASOURCE_ADDR10.xxx.xxx.xxx:5236\-eSPRING_PROFILES_ACTIVExprd\myimage:latest方式二docker-compose.ymlversion:3.8services:myapp:image:myimage:latestenvironment:-DATASOURCE_ADDR10.xxx.xxx.xxx:5236-SPRING_PROFILES_ACTIVExprd方式三env_file# .env 文件DATASOURCE_ADDR10.xxx.xxx.xxx:5236SPRING_PROFILES_ACTIVExprd# docker-compose.ymlversion:3.8services:myapp:image:myimage:latestenv_file:-.env方式四CMD 参数传递# Dockerfile ENTRYPOINT [java, -jar, app.jar] CMD [--spring.profiles.activexprd]dockerrun myimage:latest--datasource_addr10.xxx.xxx.xxx:52364.3 配置文件最佳实践推荐配置spring:datasource:url:jdbc:mysql://${DATASOURCE_ADDR:10.xxx.xxx.xxx:5236}/mydbprofiles:active:${SPRING_PROFILES_ACTIVE:default}说明占位符使用大写形式${DATASOURCE_ADDR}保留默认值作为兜底与 Linux 环境变量命名规范一致五、问题排查清单当遇到环境变量读取问题时按以下步骤排查检查环境变量是否正确设置# 在容器内执行env|grepDATASOURCE检查环境变量大小写# Linux 区分大小写echo$DATASOURCE_ADDR# 正确echo$datasource_addr# 可能为空检查 Spring Boot 启动日志# 查看实际加载的配置 DEBUGtrue java -jar app.jar验证配置文件占位符# 确保占位符格式正确${VARIABLE_NAME:default_value}检查 Dockerfile ENTRYPOINT/CMD# 确保 ENTRYPOINT 使用 exec 形式 ENTRYPOINT [java, -jar, app.jar]六、总结场景推荐做法IDEA 开发使用 Environment Variables 或 Program ArgumentsDocker 部署使用大写环境变量名 下划线分隔配置文件占位符使用大写形式保留默认值多环境配置通过 SPRING_PROFILES_ACTIVE 切换核心原则环境变量命名统一使用大写 下划线配置文件占位符与环境变量名保持一致始终提供默认值作为兜底充分理解 Spring Boot 属性绑定机制