JBoss 7.3无法记录Maven属性与命令行系统属性问题排查

核心原因 #

1. MDC与系统属性是独立机制
   日志配置里的%X{prop}是MDC（映射诊断上下文）的专属占位符，它仅读取代码中通过MDC.put()存入的键值对，不会自动关联JVM系统属性。你通过命令行传入的-Dprop=CLI_TEST属于JVM系统属性，和MDC不属于同一上下文，因此日志框架不会自动将系统属性导入MDC。

2. Maven构建属性不作用于运行时
   pom.xml中定义的<prop>TEST</prop>是构建阶段专属属性，仅在Maven打包过程中生效（比如替换资源文件中的变量），JBoss运行时无法直接读取该属性，除非你在打包阶段将其注入到运行时可识别的位置（如系统属性、配置文件）。

解决方法 #

方法一：将系统属性自动映射到MDC #

修改standalone_TEST.xml的日志子系统配置，添加MDC映射规则，让日志框架自动把指定系统属性存入MDC：

<subsystem xmlns="urn:jboss:domain:logging:8.0">
    <!-- 保留原有其他日志配置 -->
    <mdc>
        <!-- 将系统属性prop映射到MDC的prop键，默认值可自定义 -->
        <map-entry key="prop" value="${prop:DEFAULT_VALUE}"/>
    </mdc>
    <!-- 原pattern-formatter配置保持不变 -->
    <pattern-formatter pattern="%K{level}%d{HH:mm:ss,SSS} %-5p (%X{prop}) [%c] (%t) %s%e%n"/>
</subsystem>

重启JBoss后，命令行传入的-Dprop=CLI_TEST会被自动放入MDC，日志中%X{prop}即可正常显示对应值。

方法二：直接在日志pattern中引用系统属性 #

如果不需要MDC的其他特性，可直接在日志pattern里用${prop}读取系统属性，无需依赖MDC：

<pattern-formatter pattern="%K{level}%d{HH:mm:ss,SSS} %-5p (${prop:DEFAULT_VALUE}) [%c] (%t) %s%e%n"/>

这种方式更直接，无需额外配置MDC映射，启动时传入-Dprop=CLI_TEST就能直接在日志中显示对应值。

方法三：打包时注入Maven属性到运行时 #

若想让pom.xml中的<prop>TEST</prop>在运行时生效，可开启Maven资源过滤：

1. 在pom.xml中配置资源过滤，将项目内的standalone_TEST.xml（若为项目资源文件）设置为过滤文件：

<build>
    <resources>
        <resource>
            <directory>src/main/resources</directory>
            <filtering>true</filtering>
            <includes>
                <include>standalone_TEST.xml</include>
            </includes>
        </resource>
    </resources>
</build>

2. 将standalone_TEST.xml中的pattern改为(${prop})（或结合方法一/二的配置），打包时Maven会自动把${prop}替换为pom中定义的TEST。

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