Docker 中缺少环境变量时，Spring Boot 为什么未使用配置默认值？

2026-11-06数据小陈

结论

${ORGANIZATION_ID:123} 会在 ORGANIZATION_ID 未定义时使用默认值 123。题目中的异常说明外层占位符 ${organization.id} 无法解析，通常是因为 Spring 没有读到 organization.id 属性。也就是说，问题出在查找外层属性这一步，而非环境变量缺失时的默认值。

配置文件中的两层占位符作用不同：

organization.id=${ORGANIZATION_ID:123}

Spring 会先从配置源中查找 organization.id，再解析它的值 ${ORGANIZATION_ID:123}。如果 application.properties 没有加载，第一层占位符就无法解析，默认值也不会生效。

检查配置文件是否加载

确认配置文件位于 Spring Boot 默认配置位置，例如：

src/main/resources/application.properties

同时检查 Docker 实际运行的包或镜像是否包含这份文件。如果文件放在其他目录、使用了不同的 profile 文件（如 application-prod.properties），或配置目录被挂载覆盖，请确认运行时加载的是预期文件。还可以检查是否设置了 spring.config.location、spring.config.additional-location 或 spring.config.import，这些配置会影响配置来源。

异常中的 Could not resolve placeholder 'organization.id' in value "${organization.id}" 表明 Spring 在查找 organization.id 时遇到了问题。先确认应用实际读取的配置文件包含该键，再检查启动参数、profile 和容器挂载。

保留当前配置方式

如果 application.properties 已正确加载，下面的配置会在环境变量缺失时使用默认值：

host=${HOST:http://host.com}
organization.id=${ORGANIZATION_ID:123}
contenttype.id=${CONTENTTYPE_ID:110}

注入方式可以保持不变：

@Value("${organization.id}")
private String organizationId;

也可以将默认值直接写在注入处：

@Value("${ORGANIZATION_ID:123}")
private String organizationId;

这样就不需要 organization.id 这个中间属性。如果其他配置也要引用该键，仍需确认 application.properties 已加载。

注意事项

检查 Docker Compose 或启动脚本是否通过其他配置覆盖了 organization.id。这条异常只能说明 Spring 找不到外层属性，无法单独判断原因是文件未打包、位置不对、profile 不匹配，还是配置被覆盖。需要结合容器的实际启动配置逐项检查。