ngx_inet_ntop 和 ngx_sock_ntop 是 Nginx 中用于网络地址格式化的关键函数：前者将二进制地址结构直译为字符串，支持 IPv4/IPv6 自动压缩；后者在此基础上封装 socket 地址与端口，自动加方括号、转换字节序并拼接端口。
在 Nginx 源码中，ngx_inet_ntop 和 ngx_sock_ntop 是两个关键的地址格式化函数，负责将二进制网络地址（如 struct in_addr、struct in6_addr 或 struct sockaddr）转换为人类可读的点分十进制或 IPv6 字符串形式。它们不是简单封装 inet_ntop()，而是深度适配 Nginx 的内存管理、错误处理与跨平台需求。
ngx_inet_ntop：底层地址结构到字符串的直译器
ngx_inet_ntop 是最基础的地址转字符串函数，定义在 src/core/ngx_inet.c 中。它不关心 socket 上下文，只接收地址结构体指针（sa_family + 地址数据）、长度及目标缓冲区，返回写入的字节数。
- 支持
AF_INET（IPv4）和AF_INET6（IPv6），自动识别并调用对应逻辑 - 对 IPv4 使用紧凑格式（如
192.168.1.1），不补零；对 IPv6 自动压缩连续零段（如::1或2001:db8::1） - 要求调用方保证目标缓冲区足够大：
NGX_INET_ADDRSTRLEN（IPv4 最大 16 字节）或NGX_INET6_ADDRSTRLEN（IPv6 最大 46 字节） - 返回
NULL表示失败（例如 family 不支持、地址非法、缓冲区太小），否则返回指向结束符'\0'的指针
ngx_sock_ntop：面向 socket 的“即插即用”地址格式化
ngx_sock_ntop 是更高一层的封装，用于从 struct sockaddr*（可能含 port）直接生成完整地址字符串（如 "192.168.1.1:8080" 或 "[::1]:8080"）。它内部会先调用 ngx_inet_ntop 转地址，再手动拼接端口。
- 自动判断
sockaddr类型（sockaddr_in/sockaddr_in6/sockaddr_un），跳过不支持的类型（如返回NULL） - IPv6 地址外强制加方括号（
[...]），避免端口解析歧义（如[::1]:80） - 支持可选的
port参数：若为非零，拼接:port；若为 0，则只输出地址（常用于 listen 配置日志） - 缓冲区大小建议用
NGX_SOCKADDR_STRLEN（定义为 512，兼顾 UNIX 域套接字路径长度）
实际使用中的典型场景与注意事项
这两个函数广泛出现在日志记录、错误提示、配置解析与调试输出中。比如 ngx_log_error 打印客户端地址、ngx_conf_set_listen 解析 listen 指令、或 ngx_event_accept 接收新连接后记录 peer 地址。
- 不要直接传栈上小数组给
ngx_sock_ntop——Nginx 日志等模块常用ngx_str_t配合ngx_pnalloc在内存池中分配缓冲区 - 注意
ngx_sock_ntop对sockaddr的sin_port/sin6_port是网络字节序，函数内部会自动ntohs转换 - 调试时可用
ngx_log_debug+ngx_sock_ntop快速打印任意struct sockaddr_storage，比手写inet_ntop更安全可靠 - 自定义模块中若需复用逻辑，优先调
ngx_sock_ntop；仅当已有纯地址结构（无 port）且确定类型时，才用ngx_inet_ntop
源码定位与调试建议
核心实现在 src/core/ngx_inet.c，函数签名清晰：
ngx_uint_t ngx_inet_ntop(int family, void *addr, u_char *text, size_t len);
u_char *ngx_sock_ntop(struct sockaddr *sa, socklen_t socklen, u_char *text, size_t len, ngx_uint_t port);
- 在
gdb中设断点如b ngx_inet_ntop，配合print *(struct sockaddr_in*)$rdi可实时查看输入地址 - 关注返回值检查：Nginx 习惯用
if (p == NULL)判失败，而非检查 errno（因已做跨平台屏蔽） - IPv6 压缩逻辑在
ngx_inet6_ntop内部实现，遍历 8 组 16 位整数，找最长连续零段并替换为"::"
