Nginx日志系统通过ngx_log_t统一管理，采用异步写入（缓冲+定时刷盘+非阻塞I/O）和分级控制（level驱动路径选择、多目标共存），并基于worker进程隔离实现无锁线程安全。
nginx 的日志系统并非简单地调用 write() 写文件，而是通过 ngx_log_t 结构体统一管理日志行为，并在底层融合了异步写入与分级控制机制。核心在于：日志写入不阻塞事件循环，且不同级别日志可走不同路径（如 error 日志直写磁盘，debug 日志可缓冲或丢弃）。
异步写入：靠缓冲 + 定时刷盘 + 非阻塞 I/O 实现
nginx 不在每条日志产生时立即落盘。它将日志内容先写入内存缓冲区（log->wdata 指向的 buffer），由 worker 进程在空闲或定时器触发时批量刷出：
- 每个
ngx_log_t可关联一个ngx_buf_t缓冲区，启用后日志先追加到 buffer 中 - 刷盘时机包括：buffer 满、收到
ngx_signal_worker_reload信号、worker 退出前、以及主配置中log_format后指定buffer=64k触发的自动 flush - 实际写文件使用非阻塞模式打开日志文件（
O_NONBLOCK），避免因磁盘慢导致进程卡住；若 write 返回EAGAIN，则暂存并等待下次事件循环再试
分级实现：level 字段驱动路径选择与条件过滤
ngx_log_t 中的 level 字段（如 NGX_LOG_ERR、NGX_LOG_DEBUG）不仅用于判断是否输出，更决定日志流向：
- 全局日志级别（
error_log /path level）控制哪些 level 被接受；低于该级别的日志直接跳过格式化和写入逻辑 - 不同 level 可绑定不同
ngx_log_writer_pt函数指针：例如NGX_LOG_DEBUG可指向空函数或环形缓冲 writer，而NGX_LOG_ALERT强制同步写 + syslog 转发 - 模块可自定义 level 行为，比如 stream 模块的
ngx_stream_core_module在 debug 级别下会额外记录连接状态快照，但仅当log_level & NGX_LOG_DEBUG_EVENT时才生效
多级日志目标：file / syslog / stderr / 自定义 handler 共存
一个 ngx_log_t 实例可通过 handler 链表支持多个输出目标，每个节点携带自己的 level 门限：
- 主 error_log 配置生成默认 file handler；添加
error_log syslog:server=127.0.0.1:514 info会注册第二个 syslog handler，只处理 >= info 的日志 - core 模块启动时把
stderr作为 fallback handler（level =NGX_LOG_EMERG），确保最严重错误总能被看到 - 第三方模块（如 lua-nginx-module）可通过
ngx_log_set_handler()注册回调，在日志格式化完成后介入，实现审计日志分离或采样上报
线程安全与 worker 隔离：无锁设计 + 进程私有 log 实例
nginx 基于多 worker 进程模型，不依赖线程锁保障日志安全：
- 每个 worker 进程持有独立的
ngx_cycle_t->log实例，所有模块调用ngx_log_error()最终都写入本进程 log 对象 - 同一进程内，日志缓冲区由单个 writer 协程（即 event loop 主线程）独占操作，无并发写冲突
- 跨进程日志聚合需外部工具（如 logrotate、rsyslog）完成，nginx 本身不提供集中式日志服务
