在 ubuntu 系统中编译 nginx 时,如果报错提示缺少 zlib,最直接有效的解决办法是安装系统提供的 zlib 开发库。执行 sudo apt-get install zlib1g-dev 命令即可获取编译所需的头文件和静态库,随后重新运行 ./configure 脚本并继续编译流程。

如何确认当前环境是否已安装 zlib 开发包
可以通过检查特定文件是否存在或尝试配置来确认状态。若 /usr/include/zlib.h 存在,说明开发包已就绪;若不存在,则需安装。此外,直接运行 ./configure 会因找不到库而失败,这是最直观的确认方式。

sudo apt-get update sudo apt-get install zlib1g-dev # 验证头文件是否存在 test -f /usr/include/zlib.h && echo "zlib dev installed" || echo "missing"
编译 Nginx 时指定 zlib 路径的方法
当系统默认路径无法找到 zlib 或其版本冲突时,可以在 ./configure 阶段通过 --with-zlib=PATH 参数手动指定源码目录。这允许用户从非标准位置加载库,解决依赖路径问题。

# 假设 zlib 源码解压在 /tmp/zlib-1.2.13
./configure --prefix=/etc/nginx \
--with-http_gzip_static_module \
--with-zlib=/tmp/zlib-1.2.13
make
sudo make install
安装 zlib1g-dev 后 configure 的具体行为变化
在安装 zlib1g-dev 之前,Nginx 的 ./configure 脚本会检测到缺失的依赖并中止,输出类似 ./configure: error: the HTTP gzip module requires the zlib library. 的错误信息。安装完成后,脚本能成功定位 zlib.h 和 libz.a(或 .so),从而启用 HTTP 压缩模块支持,配置过程顺利结束并生成 Makefile。


















