怎么在虚拟主机层级配置mod_log_config捕捉特定的站点业务响应头-Apache-PHP中文网

Apache原生mod_log_config无法记录响应头，需用mod_lua在虚拟主机内捕获并存入notes，再通过%{X_Request_ID}n等格式符写入日志；或由Java后端在Filter中将响应头注入MDC，再由应用日志输出。

apache 的 mod_log_config 在虚拟主机层级无法直接记录响应头，包括自定义响应头（如 x-request-id、x-response-time）。这不是配置遗漏，而是模块本身的设计限制：%{headername}o 格式符在 apache 2.4 及更早版本中未被实现，写入日志格式后会留空或报错。

要实现在某个虚拟主机下精准捕获其业务响应头并写入该站点专属访问日志，需绕过原生限制，采用以下可靠路径：

虚拟主机内启用 mod_lua 捕获响应头

仅对目标启用 Lua 日志钩子，避免全局影响。

确保已加载模块：

LoadModule lua_module modules/mod_lua.so

在对应虚拟主机块中添加：

<virtualhost>
    ServerName api.example.com
    DocumentRoot /var/www/api

    # 启用 Lua 日志处理（仅此站点）
    LuaHookLog /path/to/log_headers.lua log_response

    # 自定义日志格式，使用 %n 读取 notes
    LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\" \"%{X_Request_ID}n\" \"%{X_Response_Time}n\"" api_combined
    CustomLog logs/api_access.log api_combined
</virtualhost>

对应 log_headers.lua 内容（精简安全）：

function log_response(r)
    r:note("X_Request_ID", r.headers_out["X-Request-ID"] or "-")
    r:note("X_Response_Time", r.headers_out["X-Response-Time"] or "-")
end

✅ 优势：作用域可控、不依赖后端改造、响应头值实时捕获；⚠️ 注意：需 Apache ≥ 2.4 且开启 mod_lua，Lua 脚本路径需有读权限。

改由 Java 后端在应用层注入日志字段

若站点为 Spring Boot 或 Tomcat 应用，更推荐此方式——把响应头信息“带进”日志上下文，再由 Apache 记录。

在 Filter 中将关键响应头写入 MDC（Mapped Diagnostic Context）：

@Override
public void doFilter(ServletRequest req, ServletResponse res, FilterChain chain) {
    HttpServletResponse response = (HttpServletResponse) res;
    String requestId = response.getHeader("X-Request-ID");
    String responseTime = response.getHeader("X-Response-Time");
    if (requestId != null) MDC.put("X_Request_ID", requestId);
    if (responseTime != null) MDC.put("X_Response_Time", responseTime);
    try {
        chain.doFilter(req, res);
    } finally {
        MDC.clear();
    }
}