ngx_errno_t 是 int 类型的 typedef 别名，用于统一封装系统 errno，定义于 src/core/ngx_config.h；它不重定义错误值，而是复用 errno.h 标准宏，通过 ngx_errno 宏即时捕获并用于日志可读化转换。
在 Nginx 源码中，ngx_errno_t 并不是一个独立类型，而是对系统错误码（errno）的统一别名封装，其核心作用是屏蔽平台差异、统一错误处理路径，并为日志记录提供可读性支撑。
ngx_errno_t 的本质与定义位置
它本质上是 int 类型的 typedef，在 src/core/ngx_config.h 中定义：
该定义不改变语义，但强化了“这是 Nginx 错误码上下文”的意图。Nginx 不重新定义错误值，而是直接复用 errno.h 中的标准宏（如 EAGAIN、ENOMEM、ENOENT），并在各平台编译时通过 auto/unix 脚本自动检测和适配。
错误码的获取与封装时机
Nginx 不主动“抛出”错误码，而是在系统调用或库函数失败后，立即捕获当前 errno 值并转为 ngx_errno_t 变量保存，常见于以下场景：
- 网络 I/O 失败后：如
accept()返回 -1，则立刻执行ngx_err = ngx_errno; - 文件操作失败后：如
open()失败，用ngx_errno宏（实际是errno）赋值给局部ngx_errno_t变量 - 内存分配失败时：虽
malloc不设errno，但 Nginx 封装的ngx_alloc等函数会在mmap或posix_memalign失败时主动记录系统错误
错误码如何参与日志记录
Nginx 日志模块通过 ngx_log_error() 系列函数将 ngx_errno_t 嵌入日志。关键机制如下：
- 调用时传入
err参数（即ngx_errno_t值），例如：ngx_log_error(NGX_LOG_ERR, log, err, "accept() failed") - 日志格式化器识别该参数，调用
ngx_strerror()查表转换为可读字符串（如"Resource temporarily unavailable"） -
ngx_strerror内部使用strerror_r（POSIX）或FormatMessage（Windows），确保跨平台兼容
开发者需注意的实践要点
直接使用 ngx_errno_t 本身不构成“错误处理”，它只是错误信息的载体。真正关键的是：
- 每次系统调用失败后，必须立即读取
errno（或用ngx_errno宏），延迟读取可能导致被后续系统调用覆盖 - 避免在条件分支外缓存
errno：不要写if (rc == -1) { /* 忘记读 errno */ } else { err = ngx_errno; } - 自定义模块中应统一使用
ngx_errno宏而非裸errno，以保持与 Nginx 构建配置（如--with-debug）的一致性 - 调试时可通过
ngx_log_debug输出原始数值：ngx_log_debug1(NGX_LOG_DEBUG_EVENT, log, err, "accept error: %d", err);
