Spring Boot部署Open Liberty：log_dir环境变量解析失败问题

核心原因 #

出现log_dir解析失败但log_level正常的现象，本质是Spring Boot对不同类型属性的解析策略差异，结合OpenLiberty的属性传递机制导致的：

1. 属性类型与解析逻辑差异

   • logging.level.org.springframework属于简单字符串类型属性，Spring的PropertyPlaceholderResolver会直接查找名称完全匹配的系统属性（包括下划线命名的log_level），因此可以正常解析。
   • logging.file.name是文件路径类型属性，Spring Boot在处理这类需要类型转换（转为Path/File对象）的属性时，会通过RelaxedPropertyResolver进行绑定。该解析器默认优先识别**点分隔（如log.dir）或驼峰式（如logDir）**的命名格式，下划线分隔的log_dir不在其默认匹配范围内，因此无法被解析。

2. OpenLiberty属性传递的特性
   OpenLiberty的server.env中定义的变量会以JVM系统属性的形式暴露给应用，但Spring Boot对系统属性的匹配逻辑会根据属性类型调整：简单字符串属性直接匹配变量名，而路径类属性则遵循Spring自身的命名规范进行匹配。

解决方案 #

根据你的多环境部署需求，推荐以下两种可行方案：

方案1：调整server.env中的变量命名格式 #

直接使用Spring Boot偏好的命名格式定义变量，避免下划线：

# server.env中使用点分隔
log.dir=C:\mydir
log_level=INFO

或者

# server.env中使用驼峰式
logDir=C:\mydir
log_level=INFO

然后在application.properties中对应引用：

logging.file.name=${log.dir}
# 或 logging.file.name=${logDir}
logging.level.org.springframework=${log_level}

方案2：明确指定从系统属性获取下划线命名的变量 #

如果必须保留下划线命名，可以在application.properties中通过sys:前缀明确指定从系统属性中读取：

logging.file.name=${sys:log_dir}
logging.level.org.springframework=${log_level}

补充说明 #

Spring Boot的属性绑定机制设计上更偏好点分隔或驼峰式命名，这也是官方推荐的属性命名规范。在与OpenLiberty这类容器集成时，遵循容器与框架的兼容命名格式，能避免这类解析不一致的问题。

内容的提问来源于stack exchange，提问作者pixel