Nginx不支持access_log多路复用，但可通过同一server块中配置多个access_log指令、结合log_format与map定义条件变量实现按需分流记录，支持写入不同文件、格式及远程syslog。
在 Nginx 中，Server 块本身不支持“多路复用”的 access_log（即单条请求日志同时写入多个文件或不同格式的目标），但可以通过组合使用 access_log 指令的多个实例、log_format 自定义格式、以及 map 或 if（谨慎使用）实现**按条件分流记录**，达到逻辑上的“多路输出”效果。
一、同一 Server 块中启用多个 access_log 目标
Nginx 允许在一个 server 或 location 块中声明多个 access_log 指令，每条独立生效——这是实现“多路输出”的最直接方式：
- 可分别写入不同文件（如常规日志 + 错误请求日志 + API 调试日志）
- 可绑定不同
log_format，实现格式差异化 - 支持添加
if=条件，实现按规则选择性记录
示例：
log_format main '$remote_addr - $remote_user [$time_local] "$request" '
'$status $body_bytes_sent "$http_referer" '
'"$http_user_agent"';
<p>log_format debug '$remote_addr - $remote_user [$time_local] '
'"$request" $status $request_time $upstream_response_time '
'$http_x_real_ip $http_x_forwarded_for';</p><p>server {
listen 80;
server_name example.com;</p><pre class="brush:php;toolbar:false;"># 主访问日志（全部请求）
access_log /var/log/nginx/access.log main;
# 单独记录 POST 请求到 debug 日志
access_log /var/log/nginx/post_debug.log debug if=$is_post;
# 单独记录 4xx/5xx 错误响应
access_log /var/log/nginx/error_requests.log main if=$is_error;
# 使用 map 定义变量（放在 http 块中）
# map $request_method $is_post { default 0; POST 1; }
# map $status $is_error { ~^[45] 1; default 0; }}
二、用 map 预计算日志开关变量（推荐）
避免在 access_log 中直接写复杂判断，应在 http 块中用 map 提前定义布尔变量，再在 access_log if= 中引用。Nginx 要求 map 必须定义在 http 级别：
Web Accessibility (WCAG 2 AA))
下载
将 WCAG 2 AA 无障碍标准应用于设计系统、UI 组件和网页——通过可运行的验证器进行对比度计算，采用设计 token 模式使颜色天生可访问，设定排版和焦点状态规则，并提供语义检查清单。适用于构建或审查 UI。
http {
log_format main ...;
log_format full '$time_iso8601 $host "$request" $status $bytes_sent ...';
<pre class="brush:php;toolbar:false;"># 标记含特定 header 的请求
map $http_x_debug $log_debug { "" 0; default 1; }
# 标记慢请求（>1s）
map $request_time $log_slow { ~^[1-9]\d*\.\d+ 1; default 0; }
server {
access_log /var/log/nginx/access.log main;
access_log /var/log/nginx/debug.log full if=$log_debug;
access_log /var/log/nginx/slow.log full if=$log_slow;
}}
三、注意事项与限制
-
不支持动态文件名：access_log 的路径不能含变量（如
$host），否则会报错；如需按域名分离日志，应使用split_clients或外部日志轮转工具 -
if= 条件仅支持布尔变量：不能写
if=$status > 400，必须通过 map 映射为 0/1 - 性能影响小但存在：每个 access_log 行都会触发一次磁盘 I/O；高频写入建议用 buffer 和 flush 参数优化
- location 块优先级更高：若在 location 中也配置了 access_log，会覆盖 server 级配置（除非显式继承）
四、进阶：结合 syslog 实现远程多路分发
若需将不同日志发送至不同后端（如 ELK、Splunk、S3），可用 syslog 作为中转：
access_log syslog:server=10.0.0.10:514,facility=local7,tag=nginx_api main if=$is_api; access_log syslog:server=10.0.0.11:514,facility=local6,tag=nginx_admin debug if=$is_admin;
再由 rsyslog 或 fluentd 按 tag/facility 规则路由到不同目的地。
本质上，Nginx 的 access_log 是“多目标并行写入”，不是 TCP 层的多路复用；但通过变量控制 + 多指令叠加，完全能满足按业务维度拆分、审计、监控等常见需求。
