Nginx加载Brotli模块失败求助：dlopen报错找不到共享对象文件

问题根源 #

1. libc环境不兼容：编译阶段使用的是Alpine Linux镜像（基于musl libc），但运行阶段使用的是Debian/Ubuntu系的nginx:mainline-perl（基于glibc），跨libc环境编译的动态模块无法被识别，导致出现libc.musl-x86_64.so.1找不到的报错。
2. 模块路径不匹配：Dockerfile将模块复制到了/usr/lib/nginx/modules/，但nginx.conf中配置的加载路径是/etc/nginx/modules/，路径不一致导致模块找不到。

解决方案 #

1. 统一基础镜像的libc环境 #

将运行阶段的镜像替换为Alpine版本，确保编译和运行环境的libc一致：

# 替换原有的 FROM nginx:mainline-perl
FROM nginx:${version}-alpine

# 如果需要perl环境，在Alpine基础上安装
RUN apk add --no-cache perl

2. 修正模块加载路径 #

两种可选方式，二选一即可：

方式A：修改nginx.conf的加载路径

在nginx.conf中使用模块实际存放的绝对路径：

load_module /usr/lib/nginx/modules/ngx_http_brotli_filter_module.so;
load_module /usr/lib/nginx/modules/ngx_http_brotli_static_module.so;

方式B：修改Dockerfile的COPY路径

将模块复制到nginx.conf指定的目录：

COPY --from=builder /root/nginx-${version}/objs/ngx_http_brotli_filter_module.so /etc/nginx/modules/
COPY --from=builder /root/nginx-${version}/objs/ngx_http_brotli_static_module.so /etc/nginx/modules/

3. 确保nginx版本一致 #

验证编译阶段和运行阶段的nginx版本完全相同（均使用${version}变量），避免版本不兼容导致的模块加载失败。

完整修改后的Dockerfile示例 #

ARG version=1.23.2

FROM nginx:${version}-alpine AS builder

ARG version

WORKDIR /root/

RUN apk add --update --no-cache build-base git pcre-dev openssl-dev zlib-dev linux-headers \
    && wget "http://nginx.org/download/nginx-${version}.tar.gz" \
    && tar zxf nginx-${version}.tar.gz \
    && git clone https://github.com/google/ngx_brotli.git \
    && cd ngx_brotli \
    && git submodule update --init --recursive \
    && cd ../nginx-${version} \
    && ./configure \
    --add-dynamic-module=../ngx_brotli \
    --prefix=/etc/nginx \
    --sbin-path=/usr/sbin/nginx \
    --modules-path=/usr/lib/nginx/modules \
    --conf-path=/etc/nginx/nginx.conf \
    --error-log-path=/var/log/nginx/error.log \
    --http-log-path=/var/log/nginx/access.log \
    --pid-path=/var/run/nginx.pid \
    --lock-path=/var/run/nginx.lock \
    --http-client-body-temp-path=/var/cache/nginx/client_temp \
    --http-proxy-temp-path=/var/cache/nginx/proxy_temp \
    --http-fastcgi-temp-path=/var/cache/nginx/fastcgi_temp \
    --http-uwsgi-temp-path=/var/cache/nginx/uwsgi_temp \
    --http-scgi-temp-path=/var/cache/nginx/scgi_temp \
    --with-perl_modules_path=/usr/lib/perl5/vendor_perl \
    --user=nginx \
    --group=nginx \
    --with-compat \
    --with-file-aio \
    --with-threads \
    --with-http_addition_module \
    --with-http_auth_request_module \
    --with-http_dav_module \
    --with-http_flv_module \
    --with-http_gunzip_module \
    --with-http_gzip_static_module \
    --with-http_mp4_module \
    --with-http_random_index_module \
    --with-http_realip_module \
    --with-http_secure_link_module \
    --with-http_slice_module \
    --with-http_ssl_module \
    --with-http_stub_status_module \
    --with-http_sub_module \
    --with-http_v2_module \
    --with-mail \
    --with-mail_ssl_module \
    --with-stream \
    --with-stream_realip_module \
    --with-stream_ssl_module \
    --with-stream_ssl_preread_module \
    --with-cc-opt='-Os -fomit-frame-pointer -g' \
    --with-ld-opt=-Wl,--as-needed,-O1,--sort-common \
    && make modules

FROM nginx:${version}-alpine

ARG version

RUN rm /etc/nginx/conf.d/default.conf \
    && apk add --no-cache perl  # 需要perl环境则保留，否则删除该行

COPY --from=builder /root/nginx-${version}/objs/ngx_http_brotli_filter_module.so /usr/lib/nginx/modules/
COPY --from=builder /root/nginx-${version}/objs/ngx_http_brotli_static_module.so /usr/lib/nginx/modules/

COPY ./server/nginx-config/nginx.conf /etc/nginx/

EXPOSE 80 443

验证步骤 #

1. 重新构建镜像：docker build -t nginx-brotli .
2. 启动容器：docker run -d -p 80:80 nginx-brotli
3. 查看容器日志：docker logs <container-id>，确认无启动报错
4. 测试Brotli压缩：用curl请求目标服务，检查响应头是否包含Content-Encoding: br

内容的提问来源于stack exchange，提问作者Newbie Dev