解决 nginx 源码编译时 configure 生成 makefile 失败的问题,核心在于补全缺失的系统依赖库并正确指定路径。通常是因为系统未安装 gcc、make 或 pcre-devel、zlib-devel、openssl-devel 等开发包导致检测失败。通过执行 yum install -y gcc make pcre-devel zlib-devel openssl-devel 安装这些组件后,重新运行 ./configure 即可成功生成 makefile。

configure 报错缺少 PCRE 库怎么办
当 configure 脚本提示找不到 PCRE 库时,说明系统缺乏正则表达式支持的开发文件。PCRE 是 Nginx 处理 rewrite 模块和 HTTP 模块的基础,必须显式安装对应的 -devel 包。安装完成后,无需额外参数,configure 会自动在标准路径下找到它。

# CentOS/RHEL 系统 yum install -y gcc make pcre-devel zlib-devel openssl-devel # Ubuntu/Debian 系统 apt-get install build-essential libpcre3 libpcre3-dev zlib1g-dev libssl-dev # 进入源码目录重新配置 ./configure --prefix=/usr/local/nginx
上述命令执行完毕后,configure 将顺利检测到所有必需库,并在当前目录下生成 Makefile。此时运行 make 即可开始编译。若手动指定了非标准路径的 PCRE,需使用 --with-pcre=DIR 指向解压后的源码目录,而非仅指向安装目录。
configure 报错缺少 OpenSSL 库怎么办
如果编译目标包含 HTTPS 支持(默认开启),而系统未安装 OpenSSL 开发包,configure 会因找不到 openssl/ssl.h 头文件或链接库而中止。这会导致无法生成 Makefile。解决方法是安装 openssl-devel 或 libssl-dev。若服务器出于安全合规要求禁用 SSL,也可通过 --without-http_ssl_module 参数跳过该模块的检测与编译。

# 安装 OpenSSL 开发包 yum install -y openssl-devel # 或者在 configure 时禁用 SSL 模块 ./configure --prefix=/usr/local/nginx --without-http_ssl_module
安装依赖后再次运行 ./configure,脚本将成功定位 libssl 和 libcrypto,从而完成 Makefile 的生成。注意,若之前编译过但未清理,建议先执行 make clean 或删除构建目录后重新解压源码,以避免缓存的配置冲突影响新的依赖检测结果。
如何验证 Makefile 已成功生成且环境就绪
在确认依赖安装无误后,可以通过检查 configure 的输出日志和文件系统中的 Makefile 来验证环境是否就绪。成功的标志是终端输出包含 "configuration finished" 字样,且当前目录存在 Makefile 文件。此时可直接执行 make 进行编译,若中途报错,则需根据具体错误信息回溯缺失的库或权限问题。











