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

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

<?xml version="1.0" encoding="UTF-8"?><configuration><property name="ENV" value="${ENV:-default}"></property><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
Log4j2 中如何配置环境变量占位符
Log4j2 使用 ${env:ENV} 或 ${sys:ENV} 语法。推荐使用 ${sys:ENV} 以兼容 JVM 系统属性。在 log4j2.xml 的 中直接嵌入该表达式即可。

<?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"></patternlayout></console></appenders><loggers><root level="info"><appenderref ref="Console"></appenderref></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} 且属性不存在,则显示空字符串。建议始终提供默认值以避免歧义。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











