如何配置Logback从JBoss/Wildfly外部属性文件读取变量值

多个WAR包部署在WildFly容器中，目前已经可以通过Spring的JEE命名空间，查找JNDI路径java:jboss/properties/myproperties绑定的外部属性，在Spring Bean配置中正常引用${logfile.location}这类变量值。但在Logback配置中无法读取同一份外部属性，尝试将JNDI路径填入<property>标签的file/resource属性后，始终报xxx_IS_UNDEFINED的属性未定义错误。

报错核心原因 #

• Logback原生<property>标签的file、resource属性，仅支持从本地文件系统、类路径下读取Properties文件，不具备JNDI路径解析能力，填入JNDI名称会被识别为普通文件路径，自然加载不到对应内容
• 配置中的属性占位符漏写$前缀，将标准格式的${logfile.location}错写为{logfile.location}，就算属性成功加载到上下文，也无法被正常解析识别

落地实现方案 #

1. 版本前置要求 #

确保项目引入的logback-core版本不低于1.1.0，该版本开始Logback原生支持JNDI属性查找能力，无需额外引入第三方依赖。

2. 替换错误的属性加载配置 #

移除原配置中直接指向JNDI路径的<property>标签，改用Logback内置的JNDI插入标签加载外部属性，修正后的完整配置示例：

<configuration>
  <!-- 从JNDI加载绑定的Properties对象，自动将内部所有键值对注入Logback全局上下文 -->
  <insertFromJNDI env-entry-name="java:jboss/properties/myproperties" as="externalProps" />

  <appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
    <!-- 修正占位符格式，补全$前缀 -->
    <file>${logfile.location}/logFile.log</file>
    <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
      <fileNamePattern>${logfile.location}/logFile.%d{yyyy-MM-dd}.log</fileNamePattern>
      <maxHistory>30</maxHistory>
    </rollingPolicy>

    <encoder>
      <pattern>%-4relative [%thread] %-5level %logger{35} - %msg%n</pattern>
    </encoder>
  </appender>

  <root level="DEBUG">
    <appender-ref ref="FILE" />
  </root>
</configuration>

3. 低版本兼容实现 #

如果项目使用的Logback版本低于1.1.0，无法使用<insertFromJNDI>标签，可通过应用启动监听器完成属性注入：

• 编写ServletContextListener，在Web应用上下文初始化阶段，查找JNDI绑定的Properties对象
• 将Properties中的所有键值对，通过LoggerContext提供的putProperty方法注入到Logback上下文中
  这种方式不需要修改Logback的XML文件，只要保证属性注入操作在Logback配置解析流程完成前执行，就可以正常被占位符引用。

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