一、核心需求与背景

当多台服务器（如两台应用服务器）运行相同代码时，日志文件 / 日志平台中无法直接区分日志来自哪台机器，排查问题时效率极低。解决思路是：在日志中固定输出当前服务器的 IPv4 地址，通过 IP 字段快速定位日志归属。

二、前置知识：Java 获取服务器有效 IPv4

要打印 IP 首先要能正确获取服务器的真实业务 IPv4（排除回环地址、虚拟网卡），以下是封装好的通用工具类：

1. IPv4 获取工具类（ServerIpUtils）

	import java.net.*;
	import java.util.Enumeration;
	/**
	* 服务器IP工具类：获取真实业务IPv4，缓存IP提升性能
	*/
	public class ServerIpUtils {
	// 静态缓存本机IP，仅应用启动时获取一次
	private static final String LOCAL_IP;
	// 静态代码块初始化IP
	static {
	LOCAL_IP = getMainLocalIpv4();
	}
	/**
	* 核心方法：获取服务器对外通信的主IPv4
	* 过滤回环地址、禁用网卡、虚拟网卡（Docker/VPN等）
	*/
	private static String getMainLocalIpv4() {
	try {
	Enumeration<NetworkInterface> interfaces = NetworkInterface.getNetworkInterfaces();
	while (interfaces.hasMoreElements()) {
	NetworkInterface ni = interfaces.nextElement();
	// 过滤规则：跳过回环/禁用/虚拟网卡
	if (ni.isLoopback() || !ni.isUp()
	|| ni.getName().startsWith("docker")
	|| ni.getName().startsWith("veth")) {
	continue;
	}
	// 遍历网卡下的IP地址
	Enumeration<InetAddress> addresses = ni.getInetAddresses();
	while (addresses.hasMoreElements()) {
	InetAddress addr = addresses.nextElement();
	// 仅保留IPv4地址
	if (addr instanceof Inet4Address) {
	return addr.getHostAddress();
	}
	}
	}
	} catch (SocketException e) {
	e.printStackTrace();
	}
	// 兜底返回回环地址
	return "127.0.0.1";
	}
	/**
	* 对外提供获取本机IP的方法
	*/
	public static String getLocalIp() {
	return LOCAL_IP;
	}
	}

工具类关键说明

• 缓存优化：通过静态代码块初始化 IP，仅在应用启动时获取一次，避免每次打印日志遍历网卡，提升性能；
• 精准过滤：排除回环地址（127.0.0.1）、禁用网卡、Docker/VPN 虚拟网卡，确保获取服务器真实业务 IP；
• 跨平台兼容：适配 Linux/Windows 服务器，无需修改即可使用。

三、两种日志打印 IP 的实现方案

方案 1：快速调试 - 手动拼接 IP（适合临时排查）

直接在日志语句中拼接 IP 字段，快速生效，适合临时调试场景。

代码示例

	import org.slf4j.Logger;
	import org.slf4j.LoggerFactory;
	public class BusinessService {
	// 初始化日志对象
	private static final Logger logger = LoggerFactory.getLogger(BusinessService.class);
	// 获取服务器IP（启动时加载，全局复用）
	private static final String SERVER_IP = ServerIpUtils.getLocalIp();
	public void doBusiness() {
	// 日志中拼接IP前缀，清晰标识服务器
	logger.info("[SERVER_IP:{}] 执行业务逻辑，参数：{}", SERVER_IP, "test123");
	logger.error("[SERVER_IP:{}] 业务执行失败，异常信息：{}", SERVER_IP, "空指针异常");
	}
	public static void main(String[] args) {
	new BusinessService().doBusiness();
	}
	}

输出效果

	2026-02-25 10:00:00.123 INFO [main] com.example.BusinessService - [SERVER_IP:192.168.10.20] 执行业务逻辑，参数：test123
	2026-02-25 10:00:01.456 ERROR [main] com.example.BusinessService - [SERVER_IP:192.168.10.21] 业务执行失败，异常信息：空指针异常

方案 2：生产环境 - MDC + 日志框架配置（推荐）

通过日志框架（Logback/Log4j2）的 MDC（映射诊断上下文）实现 IP 自动附加，业务代码无侵入，符合生产环境最佳实践。

步骤 1：SpringBoot 项目初始化 MDC

在应用启动时将 IP 放入 MDC，全局生效：

	import org.slf4j.MDC;
	import org.springframework.boot.SpringApplication;
	import org.springframework.boot.autoconfigure.SpringBootApplication;
	import javax.annotation.PostConstruct;
	@SpringBootApplication
	public class ServerApplication {
	public static void main(String[] args) {
	SpringApplication.run(ServerApplication.class, args);
	}
	/**
	* 项目启动后初始化MDC，添加服务器IP
	* @PostConstruct：Bean初始化完成后执行
	*/
	@PostConstruct
	public void initMdc() {
	MDC.put("SERVER_IP", ServerIpUtils.getLocalIp());
	}
	}

步骤 2：配置 Logback 日志格式（logback-spring.xml）

修改日志输出模板，自动包含 MDC 中的SERVER_IP字段：

	<?xml version="1.0" encoding="UTF-8"?>
	<configuration>
	<!-- 控制台输出 -->
	<appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
	<encoder>
	<!-- 日志格式：时间 [线程] [服务器IP] 级别 类名 - 内容 -->
	<pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] [SERVER_IP:%X{SERVER_IP}] %-5level %logger{50} - %msg%n</pattern>
	<charset>UTF-8</charset>
	</encoder>
	</appender>
	<!-- 文件输出 -->
	<appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
	<file>/logs/app.log</file>
	<!-- 按天分割日志 -->
	<rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
	<fileNamePattern>/logs/app.%d{yyyy-MM-dd}.log</fileNamePattern>
	</rollingPolicy>
	<encoder>
	<pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] [SERVER_IP:%X{SERVER_IP}] %-5level %logger{50} - %msg%n</pattern>
	<charset>UTF-8</charset>
	</encoder>
	</appender>
	<!-- 根日志级别 -->
	<root level="INFO">
	<appender-ref ref="CONSOLE"/>
	<appender-ref ref="FILE"/>
	</root>
	</configuration>

步骤 3：业务代码正常打印日志

无需手动拼接 IP，日志框架自动附加：

	logger.info("执行业务逻辑，参数：{}", "test123");
	logger.error("业务执行失败，异常：{}", e.getMessage());

最终输出效果

	2026-02-25 10:05:00.123 [main] [SERVER_IP:192.168.10.20] INFO com.example.BusinessService - 执行业务逻辑，参数：test123
	2026-02-25 10:05:01.456 [main] [SERVER_IP:192.168.10.21] ERROR com.example.BusinessService - 业务执行失败，异常：空指针异常

四、关键注意事项

1. IP 准确性：工具类过滤了 Docker、VPN 等虚拟网卡，确保获取的是服务器真实业务 IP；
2. 性能优化：IP 仅在应用启动时获取一次并缓存，避免高频日志场景下重复遍历网卡；
3. 兼容性：工具类兼容 JDK8+，支持 Linux/Windows 服务器，无需额外依赖；
4. 日志框架适配：Log4j2 配置逻辑与 Logback 一致，仅需修改日志格式中的%X{SERVER_IP}（Log4j2 中同样生效）。

五、总结

方案类型	适用场景	优点	缺点
手动拼接 IP	临时调试	实现简单、快速生效	业务代码侵入、不优雅
MDC + 日志配置	生产环境	无代码侵入、全局生效	需配置日志框架