排查Nginx编译Brotli模块“依赖库未找到”，需确认libbrotli开发库（含头文件、libbrotlienc/libbrotlidec库）是否就位，检查路径匹配、configure参数指定、submodule初始化及静态/动态链接差异。
排查 Nginx 编译 Brotli 模块时提示“依赖库未找到”，核心是确认 libbrotli 开发库是否真正就位，而非仅安装运行时库。很多故障表面是“找不到”，实则是头文件、静态/动态库、路径声明三者不匹配。
确认 libbrotli 是否已正确安装
Brotli 模块（ngx_brotli）编译时需链接 libbrotlienc（编码器）和 libbrotlidec（解码器），且必须包含开发头文件（brotli/encode.h 等）。常见误区是只装了 libbrotli1 这类运行时包，缺少 libbrotli-dev 或源码编译产物。
- 检查头文件是否存在：
ls /usr/include/brotli/encode.h或ls /usr/local/include/brotli/encode.h - 检查库文件：
find /usr -name "libbrotlienc.so*" 2>/dev/null和find /usr -name "libbrotlienc.a" 2>/dev/null - 若用源码安装（推荐），执行过
make install后，应有/usr/local/lib/libbrotlienc.so和/usr/local/include/brotli/
检查 configure 参数是否指向正确路径
Nginx 的 configure 脚本默认只在标准路径（/usr、/usr/local）搜索依赖。若 libbrotli 装在非标位置（如 /opt/brotli），必须显式告知：
- 添加编译选项：
--with-cc-opt="-I/opt/brotli/include"（指定头文件路径） - 添加链接选项：
--with-ld-opt="-L/opt/brotli/lib -lbrotlienc -lbrotlidec" - 避免只写
--with-brotli—— 这个参数并不存在，Nginx 官方无内置 Brotli 支持，必须靠--add-module引入第三方模块
验证 ngx_brotli 子模块是否初始化完成
ngx_brotli 项目自身依赖 Google 的 Brotli C 库，该库以 git submodule 形式存于 deps/brotli 目录下。若未初始化，编译时会报 "Brotli library is missing from the deps/brotli/c directory"。
- 进入
ngx_brotli目录后，运行：git submodule update --init --recursive - 确认
deps/brotli/c/下存在完整源码（含Makefile和include/目录） - 若网络受限导致克隆失败，可手动下载 brotli 源码，解压到
deps/brotli/c，再重试
区分静态链接与动态模块场景下的依赖要求
两种集成方式对依赖的处理逻辑不同，容易混淆：
- 静态编译（
--add-module=../ngx_brotli）：configure 会尝试链接libbrotlienc.a；若系统只有.so文件，可能失败，需确保.a存在或改用--with-ld-opt="-lbrotlienc"让链接器自动选 .so - 动态模块（
--add-dynamic-module=../ngx_brotli --with-compat）：编译时仍需头文件和-lbrotlienc，但运行时靠LD_LIBRARY_PATH或/etc/ld.so.conf.d/找到.so；务必在make modules后执行sudo ldconfig刷新缓存
