JNDI在Liberty Server中使用${server.config.dir}无法正常运行问题咨询

问题根因说明 #

以下是${server.config.dir}变量无法解析、最终导致JNDI查找数据源失败的常见原因：

• 变量写法或引用位置错误
  ${server.config.dir}是Liberty内置的服务器级变量，仅支持在*Liberty官方配置文件（server.xml、server.env、bootstrap.properties）*的指定属性位使用，如果你把该变量写在应用程序内部的配置文件、Java代码中，Liberty内核不会主动解析这类应用层内容里的变量。
  另外需要检查变量拼写完全正确，没有遗漏大括号、多余空格，比如错误写法${server.config.dir }、$server.config.dir都会导致解析失败。
• 配置文件加载优先级问题
  如果你的数据源配置是通过<include>标签引入的外部xml文件，且引入时设置了onConflict="IGNORE"属性，或者引入的文件不在Liberty默认的配置扫描路径下，会导致内置变量还没完成初始化就加载了数据源配置，最终变量无法被正确替换。
• 路径权限问题
  Liberty运行进程对${server.config.dir}解析后的实际路径没有读取权限时，会判定该路径无效，直接跳过数据源的初始化流程，导致jdbc/db2DataSource没有被注册到JNDI上下文，最终抛出CWWKN0008E异常。
• 必要功能未启用
  检查server.xml的<featureManager>节点，必须同时开启jndi-1.0和对应版本的JDBC功能（JDK11建议用jdbc-4.3），否则就算变量解析正常，数据源也不会被注册到JNDI容器中。

验证&优化方案 #

验证变量解析状态 #

你可以在server.xml中添加如下日志配置，打印变量的实际解析结果：

<logging traceSpecification="com.ibm.ws.config.*=all" traceFileName="config_trace.log" />

启动服务器后在日志中搜索server.config.dir，即可确认Liberty解析出来的实际路径是否符合预期。

替代硬编码的优化方案 #

你可以通过显式声明变量的方式避免内置变量的解析优先级问题：

1. 在${server.config.dir}/bootstrap.properties文件中添加自定义变量，引用内置变量：

custom.db.resource.path=${server.config.dir}/db2/driver

2. 在server.xml的数据源配置中，直接引用你自定义的变量即可：

<library id="db2DriverLib">
    <fileset dir="${custom.db.resource.path}" includes="*.jar"/>
</library>

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