Java 日志记录中日志中地址信息怎么脱敏
在 java 日志中脱敏 ip 地址,最稳妥的做法是使用正则表达式替换或自定义日志转换器。核心思路是匹配 ipv4 或 ipv6 格式,并将中间段替换为星号,例如将 192.168.1.100 变为 192.168.*.***。这样做既能保留网络拓扑结构,又能隐藏具体主机标识。

使用 Logback 的 Converter 实现自动脱敏
如果项目使用 Logback,可以通过继承 ClassicConverter 来定义一个自定义转换器,然后在日志配置文件中直接调用。这种方式侵入性最小,只需修改配置文件即可生效,无需改动业务代码中的日志打印语句。

import ch.qos.logback.classic.pattern.ClassicConverter;
import ch.qos.logback.classic.spi.ILoggingEvent;
import java.net.InetAddress;
import java.net.UnknownHostException;
import java.util.regex.Matcher;
import java.util.regex.Pattern;
public class IpAddressMaskingConverter extends ClassicConverter {
// 匹配 IPv4 地址的正则
private static final Pattern IPV4_PATTERN = Pattern.compile(
"\b(\d{1,3}\.\d{1,3}\.)(\d{1,3}\.)(\d{1,3})\b"
);
@Override
public String convert(ILoggingEvent event) {
String message = event.getMessage();
if (message == null) {
return "";
}
// 执行替换
return maskIp(message);
}
private String maskIp(String text) {
Matcher matcher = IPV4_PATTERN.matcher(text);
StringBuffer sb = new StringBuffer();
while (matcher.find()) {
// 捕获组1: 前两段 (如 192.168.)
// 捕获组2: 第三段加点 (如 1.)
// 捕获组3: 第四段 (如 100)
String group1 = matcher.group(1);
String group2 = matcher.group(2);
String group3 = matcher.group(3);
// 简单脱敏:最后一段变 *,倒数第二段变 *
// 这里演示一种常见的脱敏策略:保留前两段,后两段打码
// 实际可根据需求调整,例如只打码最后一段
String masked = group1 + "*.*";
matcher.appendReplacement(sb, masked);
}
matcher.appendTail(sb);
return sb.toString();
}
}
在 logback.xml 中注册并使用:
使用Atmosphere构建通过WebSocket、SSE、gRPC、WebTransport、MCP、A2A和AG-UI流传输的JVM代理网关,并带有治理钩子。
<configuration><conversionrule conversionword="maskip" converterclass="IpAddressMaskingConverter"></conversionrule><appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender"><encoder><pattern>%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{36} - %maskip%msg%n</pattern></encoder></appender><root level="INFO"><appender-ref ref="STDOUT"></appender-ref></root></configuration>
使用 SLF4J MDC 结合过滤器进行脱敏
对于更复杂的场景,或者需要脱敏特定字段(如请求头中的 IP),可以在 Servlet Filter 或 Spring Interceptor 中获取客户端 IP,并通过 MDC 放入上下文。随后在日志输出时,通过特定的格式化逻辑或 AOP 对包含 IP 的日志事件进行处理。这种方法适合需要对非日志消息内容(如 HTTP 请求参数)进行脱敏的场景。

import org.slf4j.MDC;
import javax.servlet.*;
import javax.servlet.http.HttpServletRequest;
import java.io.IOException;
public class IpLoggingFilter implements Filter {
@Override
public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
throws IOException, ServletException {
HttpServletRequest httpRequest = (HttpServletRequest) request;
String clientIp = getClientIp(httpRequest);
try {
// 将原始 IP 放入 MDC,供日志使用
MDC.put("clientIp", clientIp);
chain.doFilter(request, response);
} finally {
// 清理 MDC,防止内存泄漏
MDC.remove("clientIp");
}
}
private String getClientIp(HttpServletRequest request) {
String ip = request.getHeader("X-Forwarded-For");
if (ip == null || ip.length() == 0 || "unknown".equalsIgnoreCase(ip)) {
ip = request.getHeader("Proxy-Client-IP");
}
if (ip == null || ip.length() == 0 || "unknown".equalsIgnoreCase(ip)) {
ip = request.getHeader("WL-Proxy-Client-IP");
}
if (ip == null || ip.length() == 0 || "unknown".equalsIgnoreCase(ip)) {
ip = request.getRemoteAddr();
}
// 处理多级代理的情况,取第一个 IP
if (ip != null && ip.contains(",")) {
ip = ip.split(",")[0];
}
return ip;
}
}
基于程序中某个输入、条件或结果的具体问题
当输入中包含非标准格式的 IP 地址,例如带有端口号的字符串 192.168.1.1:8080 时,上述正则表达式可能会因为冒号的存在而匹配失败或行为异常。需要确认的是,当前的正则 (d{1,3}.d{1,3}.)(d{1,3}.)(d{1,3}) 中的 单词边界在遇到冒号时是否依然有效。经测试, 在数字和冒号之间被视为边界,因此能正确匹配到 192.168.1.1 部分,而忽略后面的 :8080。但如果输入是纯文本描述如 IP is 192.168.1.1 port 8080,也能正常脱敏。若需同时脱敏端口,需扩展正则以匹配 :port 部分。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










