底层架构指南：Nginx中ngx_errno_t全局错误码的封装与记录-Nginx-PHP中文网

ngx_errno_t 是 int 类型的 typedef 别名，用于统一封装系统 errno，定义于 src/core/ngx_config.h；它不重定义错误值，而是复用 errno.h 标准宏，通过 ngx_errno 宏即时捕获并用于日志可读化转换。

底层架构指南：nginx中ngx_errno_t全局错误码的封装与记录

在 Nginx 源码中，ngx_errno_t 并不是一个独立类型，而是对系统错误码（errno）的统一别名封装，其核心作用是屏蔽平台差异、统一错误处理路径，并为日志记录提供可读性支撑。

它本质上是 int 类型的 typedef，在 src/core/ngx_config.h 中定义：

typedef int ngx_errno_t;

该定义不改变语义，但强化了“这是 Nginx 错误码上下文”的意图。Nginx 不重新定义错误值，而是直接复用 errno.h 中的标准宏（如 EAGAIN、ENOMEM、ENOENT），并在各平台编译时通过 auto/unix 脚本自动检测和适配。

Nginx 不主动“抛出”错误码，而是在系统调用或库函数失败后，立即捕获当前 errno 值并转为 ngx_errno_t 变量保存，常见于以下场景：

Nginx Hosting

通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载

网络 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);