必须关闭 daemon 模式并重定向 access_log 至 /dev/stdout，同时定义含 $request_uri、$request_time 和 $upstream_response_time 的 log_format；否则日志无法输出至标准流或缺失关键字段。
Nginx 的 access_log 在容器化环境中要被可靠收集，关键不是“怎么采集”，而是先让它真正输出到标准输出——Docker 和 Kubernetes 只能捕获 stdout/stderr，不会读取 /var/log/nginx/access.log 这类文件。
必须关闭 daemon 模式并重定向日志目标
Nginx 默认以守护进程（daemon）方式运行，会脱离终端上下文，导致写入 /dev/stdout 失效或静默丢弃。
必须在启动时强制前台运行：
- 在
nginx.conf的 main 上下文（全局块） 中添加：daemon off;
- 或者在容器启动命令中指定：
nginx -g "daemon off; error_log /dev/stderr warn;" -c /etc/nginx/nginx.conf
同时明确日志输出路径：
access_log /dev/stdout main; error_log /dev/stderr warn;
⚠️ 注意：
/dev/stdout和/dev/stderr是设备节点，不是普通文件。Nginx ≥1.7.0 原生支持，无需额外模块，但需确保运行用户（如nginx或www-data）有写权限（通常默认满足）。
定义含关键字段的 log_format（避免日志信息缺失）
默认 main 格式不包含 $request_time、$upstream_response_time 或完整原始路径 $request_uri。若需性能分析或链路追踪，建议自定义格式：
log_format enhanced '$remote_addr - $remote_user [$time_local] '
'"$request_method $request_uri $server_protocol" '
'$status $body_bytes_sent "$http_referer" '
'"$http_user_agent" $request_time $upstream_response_time '
'$http_x_forwarded_for $scheme $server_name';然后在 http 块中启用：
access_log /dev/stdout enhanced;
✅
$request_uri记录带 query string 的原始请求；$request_time是总耗时（毫秒级），比$upstream_response_time更全面（后者仅在 proxy 场景有效）。
避免 location 级别配置覆盖全局日志设置
access_log 指令作用域为 http、server 或 location。若某 location 中写了：
将 WCAG 2 AA 无障碍标准应用于设计系统、UI 组件和网页——通过可运行的验证器进行对比度计算，采用设计 token 模式使颜色天生可访问，设定排版和焦点状态规则，并提供语义检查清单。适用于构建或审查 UI。
location /static/ {
access_log off; # ❌ 会屏蔽上级 /dev/stdout 设置
}该路径下的访问将完全不记日志。
正确做法是保留日志，用 log_not_found off; 或 map + log_if 过滤低价值请求，而非关闭整个日志流。
验证是否生效：用 docker logs 直接看
容器启动后执行：
docker logs -f <container-name>
应实时看到类似以下内容：
172.18.0.1 - - [02/Oct/2026:21:05:33 +0000] "GET /api/users?id=123 HTTP/1.1" 200 142 "-" "curl/7.68.0" 0.023 0.021 "-" https example.com
如果没输出，检查三点：
-
daemon off;是否生效（ps aux | grep nginx应无master process分离） -
access_log指令是否被location或server块中的同名指令覆盖 - 配置是否已重载（
nginx -t && nginx -s reload不适用于容器，应重启容器）
不复杂但容易忽略。
