apache http server 通过 setenvif 指令结合请求特征设置环境变量，再在 customlog 中用 env= 参数实现对 java 后端应用的条件日志记录，支持按路径、方法、状态码、响应头等精细化控制，并需配合 x-forwarded-for 获取真实 ip。

Apache HTTP Server 本身不直接执行 Java 代码，所谓“Java 中 Apache 利用条件日志记录”实际是指：在 Java Web 应用（如基于 Tomcat、Jetty 等 Servlet 容器）部署于 Apache 后端（常见为 Apache + mod_proxy 或 mod_jk 反向代理架构）时，通过 Apache 的 LogFormat 和 SetEnvIf（或 SetEnvIfNoCase）指令，结合请求特征（如 URL 路径、User-Agent、Referer、HTTP 方法、响应状态等），对转发到后端 Java 应用的请求进行条件判断，并控制是否写入访问日志或使用不同日志格式。

利用 SetEnvIf 匹配请求特征并设置环境变量

这是实现条件日志的核心机制。Apache 先根据请求属性动态设置环境变量，再在 CustomLog 中通过 env= 参数决定是否记录该请求。

• 匹配特定路径（如静态资源）：
  SetEnvIf Request_URI "\.(js|css|png|jpg|gif|ico)$" static_request
  此行将所有以 .js、.css 等结尾的请求标记为 static_request 环境变量。
• 排除健康检查或监控探针：
  SetEnvIf Request_URI "^/health$" no_log
  避免将 /health 接口调用写入主访问日志，减少日志噪音。
• 按 HTTP 方法过滤（如忽略 OPTIONS 预检）：
  SetEnvIf Request_Method "OPTIONS" no_log

定义差异化日志格式并绑定环境变量

使用 LogFormat 自定义字段（例如添加响应时间、上游状态、X-Forwarded-For 真实 IP），再通过 CustomLog 的 env= 条件限定生效范围。

• 仅记录 Java 后端返回 5xx 的错误请求：
  SetEnvIf StatusCode "^5[0-9]{2}$" error_5xx
  CustomLog logs/error-5xx.log combined env=error_5xx
• 单独记录 API 请求（如 /api/ 开头）：
  SetEnvIf Request_URI "^/api/" api_request
  LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\" %{ms}T" api_format
  CustomLog logs/api-access.log api_format env=api_request

结合 mod_headers 和 X-Forwarded-* 处理真实客户端信息

因 Java 应用运行在 Apache 后端，原始请求经代理转发，%h 默认是 Apache 本机地址。需确保 Apache 正确设置 X-Forwarded-For，并在日志中使用 %{X-Forwarded-For}i 获取真实 IP。

• 启用 mod_headers 并配置：
  RequestHeader set X-Forwarded-For %{REMOTE_ADDR}e env=remoteip
• 在 LogFormat 中引用：
  LogFormat "%{X-Forwarded-For}i %l %u %t \"%r\" %>s %b" realip_format
• 注意：生产环境应校验 X-Forwarded-For 是否可信（如只信任来自内网的代理头），避免伪造。

与 Java 应用协同增强日志语义（可选但推荐）

Apache 无法直接读取 Java 应用内部逻辑（如 Spring Boot 的 @Controller 映射或业务类型），但可通过约定方式增强上下文：

• Java 应用在响应头中写入自定义标识：
  response.setHeader("X-App-Category", "payment");
• Apache 捕获该响应头（需 mod_headers 和 mod_setenvif 支持）：
  SetEnvIfNoCase ^X-App-Category$ "payment" payment_request
• 后续可用于定向日志或限流：
  CustomLog logs/payment.log combined env=payment_request

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