在 java 日志记录中,可以通过配置日志框架(如 logback 或 log4j2)的 patternlayout,在日志输出格式中加入自定义的环境标识变量来实现。具体做法是在配置文件中使用 %property{env} 或类似语法,并在应用启动时通过 jvm 参数 -denv=dev 或环境变量注入该值,这样每条日志都会自动带上当前运行的环境名。

Logback 中如何配置环境变量占位符
Logback 支持使用 ${ENV} 或 %property{ENV} 来引用系统属性。需要在 logback.xml 的 <configuration></configuration> 根节点下定义 <property></property> 或使用默认值,然后在 <pattern></pattern> 中引用。如果未设置,可以指定一个默认值如 unknown。

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
<property name="ENV" value="${ENV:-default}" />
<appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
<encoder>
<pattern>%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{36} [ENV:%property{ENV}] - %msg%n</pattern>
</encoder>
</appender>
<root level="INFO">
<appender-ref ref="STDOUT" /</appender-ref>
</root>
</configuration>
运行命令:java -DENV=production -jar app.jar。预期输出:2023-10-01 12:00:00 [main] INFO com.example.App [ENV:production] - Hello World
立即学习“Java免费学习笔记(深入)”;
Log4j2 中如何配置环境变量占位符
Log4j2 使用 ${env:ENV} 或 ${sys:ENV} 语法。推荐使用 ${sys:ENV} 以兼容 JVM 系统属性。在 log4j2.xml 的 <patternlayout></patternlayout> 中直接嵌入该表达式即可。

<?xml version="1.0" encoding="UTF-8"?>
<Configuration status="WARN">
<Appenders>
<Console name="Console" target="SYSTEM_OUT">
<PatternLayout pattern="%d{yyyy-MM-dd HH:mm:ss} [%t] %-5level %logger{36} [ENV:${sys:ENV}] - %msg%n" />
</Console>
</Appenders>
<Loggers>
<Root level="info">
<AppenderRef ref="Console" />
</Root>
</Loggers>
</Configuration>
运行命令:java -DENV=staging -jar app.jar。预期输出:2023-10-01 12:00:00 [main] INFO com.example.App [ENV:staging] - Hello World
当 ENV 系统属性未设置时日志会显示什么
如果未通过 -DENV=xxx 设置系统属性,Logback 和 Log4j2 的行为取决于配置中的默认值处理。Logback 中若使用 ${ENV:-default},则显示 default;若直接使用 %property{ENV} 且无默认值,则显示空字符串或 null。Log4j2 中若使用 ${sys:ENV} 且属性不存在,则显示空字符串。建议始终提供默认值以避免歧义。


















