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。
立即学习“Java免费学习笔记（深入）”；
- 启用
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
