Open Liberty中如何将环境变量作为应用属性注入应用

之前配置失效的核心原因 #

• server.xml里直接写${LDAP_URL}读不到值：Open Liberty默认不会直接解析裸的环境变量名作为配置占位符，变量匹配有固定的前缀规则
• jvm.options中配置-Dmy.ldap.url=$LDAP_URL失效：jvm.options由JVM直接加载，不会触发Shell的变量替换逻辑，最终赋值给属性的是字面量$LDAP_URL，不是环境变量的实际值
• 配置<library>加载properties文件的方式属于标签误用：<library>标签是用来给应用、运行时添加依赖类路径的，没有加载配置属性的作用
• server.env里配置的参数是供Liberty进程自身读取的运行时环境变量，不会自动映射为应用可读取的应用属性

可直接落地的实现方案 #

方案1：bootstrap.properties映射（全版本兼容，最稳定） #

在和server.xml同级的服务器配置目录下，新建或修改bootstrap.properties文件，添加一行配置：

my.ldap.url=${LDAP_URL}

重启服务后即可生效。Liberty启动阶段会最先加载这个配置文件，并且会自动解析占位符引用的系统环境变量完成替换。替换后的值既可以在server.xml其他配置项里通过${my.ldap.url}引用，应用侧也可以通过Spring的@Value注解读取，或者直接通过System.getProperty("my.ldap.url")拿到实际值。

方案2：带环境变量前缀直接在server.xml引用（适用于21.0.0.3及以上版本） #

如果你的Open Liberty版本在21.0.0.3以上，变量解析器原生支持env.前缀匹配环境变量，不需要额外配置文件，直接把server.xml里的配置改成下面的写法即可：

<variable name="my.ldap.url" value="${env.LDAP_URL}" />

只要系统中存在LDAP_URL这个环境变量，Liberty启动时会自动完成值替换。

方案3：启动命令直接传参（和JBoss操作逻辑一致） #

如果习惯和之前用JBoss一样在启动时传参，直接把-D参数拼在启动命令上即可，不要写在jvm.options里。Shell会在执行启动命令前先完成$LDAP_URL的替换，再把实际值传给JVM：

./bin/server start yourServerName -Dmy.ldap.url=$LDAP_URL

避坑提示：jvm.options里的配置不会经过Shell解析，所有写在里面的$变量都会被当成普通字符串处理，不要在这个文件里写依赖Shell替换的参数。

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