Spring Boot 2.3.4如何在application.properties中配置带[主机:端口]的日志前缀

问题根因 #

日志框架（Logback/Log4j2）的初始化时机早于Spring上下文及Web容器的启动流程：

• 固定端口场景下，日志系统初始化时server.port配置还未被Spring环境完成解析加载，因此出现server.port_IS_UNDEFINED提示
• 随机端口（server.port=0）场景下，配置中的0只是随机端口的标识，实际绑定端口是Web容器启动后动态分配的，日志初始化阶段根本无法拿到最终端口值

无需修改日志框架XML配置的解决方案 #

方案一：固定端口场景快速适配

如果不需要使用随机端口，只需要在启动时将server.port作为系统属性传入，日志系统就能直接读取到对应值：

1. 启动命令添加JVM参数：
   java -Dserver.port=8080 -jar your-app.jar
2. 保留原日志格式配置即可：

logging.pattern.console=[${HOSTNAME}:${server.port}] %d{HH:mm dd-MM-yy} <%logger{10}> : %msg%n

方案二：兼容随机端口场景（通用方案）

通过Spring自带的Web容器初始化事件监听，动态将实际端口注入日志MDC上下文，全程无需修改日志框架的XML配置：

1. 调整application.properties中的日志格式，使用MDC占位符%X{server.port}读取端口：

logging.pattern.console=[${HOSTNAME}:%X{server.port}] %d{HH:mm dd-MM-yy} <%logger{10}> : %msg%n

2. 添加一个监听器类，无需额外配置，Spring会自动扫描加载：

import org.slf4j.MDC;
import org.springframework.boot.web.context.WebServerInitializedEvent;
import org.springframework.context.ApplicationListener;
import org.springframework.stereotype.Component;

@Component
public class ServerPortMdcInjector implements ApplicationListener<WebServerInitializedEvent> {
    @Override
    public void onApplicationEvent(WebServerInitializedEvent event) {
        // 直接获取Web容器实际绑定的端口，支持随机端口场景
        int actualPort = event.getWebServer().getPort();
        MDC.put("server.port", String.valueOf(actualPort));
    }
}

注意：Web容器初始化完成之前的启动日志，端口位置会显示为空，这是正常现象，Web容器启动完成后的所有业务日志都会正常展示实际端口值。

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