Java 日志记录中 HTTP 访问日志怎么记录

大杰吖_8871

大杰吖_8871

2026-11-19

345人浏览

原创

在 java 中记录 http 访问日志,最标准且高效的做法是利用 servlet 规范中的 filter 机制拦截请求,结合 httpservletrequest 获取关键信息并写入日志。通过实现 javax.servlet.filter(或 jakarta ee 的 jakarta.servlet.filter),可以在请求到达 controller 之前和响应返回之后,分别记录请求方法、url、状态码和耗时,从而形成完整的访问链路日志。

Java 日志记录中 HTTP 访问日志怎么记录

如何配置 Filter 以捕获请求与响应元数据

要捕获 HTTP 访问日志,需要创建一个实现了 Filter 接口的类,并在其中重写 doFilter 方法。在该方法中,首先记录请求开始时间,然后调用 chain.doFilter() 放行请求,待响应生成后,再次获取响应状态码并计算耗时。这种方式不侵入业务代码,能统一处理所有进入应用的 HTTP 请求。

Java 日志记录中 HTTP 访问日志怎么记录

import javax.servlet.*;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.util.logging.Logger;

public class AccessLogFilter implements Filter {
    private static final Logger logger = Logger.getLogger(AccessLogFilter.class.getName());

    @Override
    public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
            throws IOException, ServletException {
        HttpServletRequest httpRequest = (HttpServletRequest) request;
        HttpServletResponse httpResponse = (HttpServletResponse) response;
        
        long startTime = System.currentTimeMillis();
        String method = httpRequest.getMethod();
        String uri = httpRequest.getRequestURI();
        
        try {
            chain.doFilter(request, response);
        } finally {
            long endTime = System.currentTimeMillis();
            int status = httpResponse.getStatus();
            long duration = endTime - startTime;
            
            // 记录格式:METHOD URI STATUS DURATION(ms)
            logger.info(String.format("%s %s %d %dms", method, uri, status, duration));
        }
    }
}

上述代码展示了核心的过滤逻辑。在 finally 块中记录日志确保了即使发生异常也能输出状态码(通常为 500)。使用 java.util.logging 作为基础日志框架,实际项目中可替换为 Logback 或 Log4j2。该过滤器需通过 @WebFilter 注解或在 web.xml 中注册,指定拦截路径如 /* 以覆盖所有请求。

如何处理请求体与查询参数以避免性能损耗

直接读取请求体(Body)会导致流被消费,后续业务代码无法再次读取,因此必须使用包装器(Wrapper)来缓存输入流。对于查询参数(Query Parameters),由于它们位于 URL 中而非流中,可以直接从 HttpServletRequest 获取,无需特殊处理。在 Filter 中记录日志时,应优先记录 URL 和参数,对 Body 内容仅在调试模式下谨慎记录,以免因大文件上传导致内存溢出或性能下降。

Java 日志记录中 HTTP 访问日志怎么记录

Java基础版
Java基础版

编写健壮 Java 代码的基础能力,覆盖空指针防护、相等性判断与基础异常处理。

下载
import javax.servlet.*;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletRequestWrapper;
import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStreamReader;

public class CachedBodyHttpServletRequest extends HttpServletRequestWrapper {
    private byte[] cachedBody;

    public CachedBodyHttpServletRequest(HttpServletRequest request) throws IOException {
        super(request);
        // 缓存请求体
        BufferedReader reader = request.getReader();
        StringBuilder sb = new StringBuilder();
        String line;
        while ((line = reader.readLine()) != null) {
            sb.append(line);
        }
        cachedBody = sb.toString().getBytes();
    }

    @Override
    public ServletInputStream getInputStream() throws IOException {
        return new CachedBodyServletInputStream(cachedBody);
    }

    @Override
    public BufferedReader getReader() throws IOException {
        return new BufferedReader(new InputStreamReader(getInputStream()));
    }
}

// 辅助类:提供 ByteArrayInputStream 的 ServletInputStream 实现
class CachedBodyServletInputStream extends ServletInputStream {
    private final java.io.ByteArrayInputStream buffer;
    public CachedBodyServletInputStream(byte[] content) {
        this.buffer = new java.io.ByteArrayInputStream(content);
    }
    @Override
    public boolean isFinished() { return buffer.available() == 0; }
    @Override
    public boolean isReady() { return true; }
    @Override
    public void setReadListener(ReadListener listener) {}
    @Override
    public int read() { return buffer.read(); }
}

在实际应用中,若需记录 POST 请求的 JSON 或表单数据,可使用上述 CachedBodyHttpServletRequest 包装原始请求。在 Filter 中,先判断是否为 POST 请求且 Content-Type 为 application/json,若是则创建包装实例并传入链式调用。这样,Controller 层仍能正常读取请求体,而 Filter 层已保存副本用于日志记录。注意,仅当业务确实需要审计请求体时才启用此功能,否则会增加不必要的 I/O 开销。

如何根据特定条件过滤或格式化日志输出

并非所有 HTTP 请求都需要同等粒度的日志记录。例如,健康检查接口(如 /health)或静态资源请求(.css, .js, .png)通常产生大量低价值日志。可以通过在 Filter 中添加条件判断,对这些请求跳过详细日志记录,或仅记录极简信息。此外,可根据用户角色或请求头动态调整日志级别,确保生产环境日志既完整又不冗余。

以下代码演示了如何在 Filter 中集成条件过滤逻辑:

import javax.servlet.*;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.util.Arrays;
import java.util.List;
import java.util.logging.Level;
import java.util.logging.Logger;

public class SmartAccessLogFilter implements Filter {
    private static final Logger logger = Logger.getLogger(SmartAccessLogFilter.class.getName());
    private static final List<string> EXCLUDED_PATHS = Arrays.asList("/health", "/favicon.ico");
    private static final List<string> STATIC_EXTENSIONS = Arrays.asList(".css", ".js", ".png", ".jpg", ".ico");

    @Override
    public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
            throws IOException, ServletException {
        HttpServletRequest httpRequest = (HttpServletRequest) request;
        HttpServletResponse httpResponse = (HttpServletResponse) response;
        
        String uri = httpRequest.getRequestURI();
        boolean shouldLog = !EXCLUDED_PATHS.contains(uri) && 
                            STATIC_EXTENSIONS.stream().noneMatch(uri::endsWith);
        
        if (!shouldLog) {
            chain.doFilter(request, response);
            return;
        }
        
        long startTime = System.currentTimeMillis();
        try {
            chain.doFilter(request, response);
        } finally {
            long duration = System.currentTimeMillis() - startTime;
            int status = httpResponse.getStatus();
            
            // 根据状态码设置日志级别
            Level level = (status >= 500) ? Level.SEVERE : Level.INFO;
            logger.log(level, String.format("[%s] %s %d %dms", 
                httpRequest.getMethod(), uri, status, duration));
        }
    }
}</string></string>

该实现通过排除路径列表和静态资源后缀,显著减少了无效日志条目。同时,根据 HTTP 状态码动态调整日志级别(如 5xx 错误记为 SEVERE),有助于运维人员快速定位严重问题。这种策略在保证关键请求可追溯的同时,降低了日志存储成本和检索负担。

Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

java

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.15

12937

6

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

2023.07.05

10002

9

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

2023.07.31

8492

8

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.01

1344

3

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.02

1068

3

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

1616

5

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

3389

5

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

2023.08.03

20611

3

配置java环境变量
配置java环境变量

配置Java环境变量是为了让操作系统能够识别和使用Java的相关命令和功能。本专题为大家提供配置java环境变量相关文章,帮助大家解决问题。

2023.08.03

1475

8

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
dev.java 官方:Learn Java
dev.java 官方:Learn Java

共0课时 | 0人学习

Java JDBC数据库连接官方教程
Java JDBC数据库连接官方教程

共0课时 | 0人学习