如何在Dockerfile中修改MariaDB C++连接器的CMake安装路径？

问题背景 #

在Docker中构建MariaDB C++连接器时，编译安装后共享库被放置在/usr/local/lib/mariadb/libmariadbcpp.so路径下，而非常规的/usr/local/lib目录，导致应用运行时无法找到该共享库，希望通过优雅的配置解决，避免手动复制文件。

优雅解决方案 #

1. 修改CMake安装路径参数 #

在编译MariaDB连接器的cmake命令中，添加-DCMAKE_INSTALL_LIBDIR=lib参数，强制将库文件直接安装到CMAKE_INSTALL_PREFIX下的lib目录，而非默认的子目录：

# 替换builder阶段原cmake命令
cmake ../ -DCMAKE_BUILD_TYPE=RelWithDebInfo -DCONC_WITH_UNIT_TESTS=Off -DCMAKE_INSTALL_PREFIX=/usr/local -DWITH_SSL=OPENSSL -DCMAKE_INSTALL_LIBDIR=lib;

这个参数会覆盖连接器默认的库安装路径配置，让make install将libmariadbcpp.so直接放到/usr/local/lib下，和其他库保持一致，应用运行时就能自动找到。

2. 配置动态链接器搜索路径（无需修改安装路径） #

如果不想改变连接器的默认安装结构，可以在runtime阶段配置系统动态链接器，让它能找到子目录下的库：

方法A：添加ld配置文件

在runtime阶段添加以下命令，创建ld配置文件并更新缓存：

FROM base AS runtime

COPY --from=builder /usr/local/bin /usr/local/bin
COPY --from=builder /usr/local/lib /usr/local/lib

# 添加ld搜索路径
RUN echo "/usr/local/lib/mariadb" > /etc/ld.so.conf.d/mariadb.conf && ldconfig

# 后续entrypoint等配置

方法B：设置环境变量

在容器启动时设置LD_LIBRARY_PATH环境变量，临时扩展搜索路径：

FROM base AS runtime

COPY --from=builder /usr/local/bin /usr/local/bin
COPY --from=builder /usr/local/lib /usr/local/lib

ENV LD_LIBRARY_PATH="/usr/local/lib/mariadb:$LD_LIBRARY_PATH"

# 后续entrypoint等配置

3. 编译应用时指定库搜索路径 #

如果应用使用Makefile编译，可以在编译命令中添加-L/usr/local/lib/mariadb参数指定库路径：

# 在你的myapp的Makefile中修改链接命令
myapp: myapp.o
    g++ myapp.o -o myapp -lmariadbcpp -L/usr/local/lib/mariadb

如果应用使用CMake构建，可以在CMakeLists.txt中添加：

set(CMAKE_PREFIX_PATH "/usr/local/lib/mariadb")
find_package(MariaDBConnectorCPP REQUIRED)

这样编译应用时就能找到对应的库，运行时也无需额外配置（前提是库文件已复制到容器中）。

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