源码安装Nginx时configure失败主因是环境缺失：先运行gcc --version和make --version确认编译器可用；再检查pcre-devel、zlib-devel、openssl-devel等开发包是否安装，而非仅运行库；若configure提示某库“not found”，需用pkg-config或ls /usr/include/验证头文件存在，并注意非标准路径需显式指定--with-xxx参数。
源码安装 Nginx 时编译中断或 configure 失败，绝大多数情况不是 Nginx 本身有问题，而是系统环境或依赖没配齐。关键要分清是“找不到编译器”“缺头文件”“库版本不匹配”，还是“configure 参数写错了”。下面按高频场景直接说排查动作。
先看错误出现在哪个阶段
不同阶段报错指向完全不同问题：
- 执行 ./configure 就失败：大概率是 gcc、pcre-devel、zlib-devel、openssl-devel 这类开发包没装，或者路径权限不对；
- configure 成功但 make 报错：常见于内核头文件缺失（如 SOCK_NONBLOCK 未声明）、zlib.h 找不到、或第三方模块 ABI 不兼容；
- make 成功但 nginx -t 段错误：说明二进制已生成，但运行时链接失败（ldd 看缺啥.so）、配置用了未编译的模块、或 /etc/hosts 格式异常。
快速确认基础编译环境是否完整
别跳过这步，最小化系统常缺这些：
- 运行
gcc --version和make --version，无输出就装构建工具链：
CentOS/RHEL：sudo dnf groupinstall "Development Tools"
Ubuntu/Debian：sudo apt install build-essential - 检查关键开发包是否到位：
pcre：pkg-config --exists pcre && echo OK || echo missing
zlib：ls /usr/include/zlib.h &>/dev/null && echo OK || echo missing
>OpenSSL：ls /usr/include/openssl/ssl.h &>/dev/null && echo OK || echo missing
重点盯住 configure 输出末尾和 config.log
configure 脚本不会直接告诉你“你少装了啥”，但它会留下线索：
- 末尾 summary 区域里，如果看到
http_gzip_module disabled或the HTTP rewrite module requires the pcre library，基本就是对应-devel包没装； - 当前目录下生成的
config.log是真相所在，用grep -i "not found\|error\|failed" config.log | tail -10快速定位失败检测项； - 若提示
checking for OpenSSL library ... not found，但 openssl-devel 已装，可能是它装在非标准路径（如 /opt/openssl），需加--with-openssl=/opt/openssl。
make 阶段中断常见真因与验证法
这类错误容易误判为代码问题，其实多是系统级缺失：
- 报
‘EPOLL_CLOEXEC’ undeclared或‘AF_MAX’ undeclared：内核头文件没装。运行：
ls /usr/include/linux/version.h &>/dev/null && echo OK || echo missing
然后按发行版装对应包：
CentOS/Rocky：sudo dnf install kernel-headers-$(uname -r)
Ubuntu：sudo apt install linux-headers-$(uname -r) - 报
fatal error: zlib.h: No such file or directory：zlib-devel 名称或架构路径不对。Ubuntu 要zlib1g-dev，RHEL 系是zlib-devel，银河麒麟 V10 离线需手动匹配 rpm 包。 - 报
make: *** 没有规则可以创建“default”需要的目标“build”：90% 是 configure 因依赖缺失提前退出，导致 Makefile 生成不全。回看 configure 是否真的走完了，别只盯 make 错误。
