在Debian系Apache Docker镜像中安装DBD::mysql失败求助

问题根源 #

编译错误里的未声明标识符（如MYSQL_OPT_GET_SERVER_PUBLIC_KEY、SSL_MODE_PREFERRED）以及未定义函数mysql_real_escape_string_quote，核心原因是你安装的libmariadb-dev版本过旧，不支持DBD::mysql 5.001依赖的新客户端API特性。这些SSL相关宏和函数是MariaDB 10.2+才引入的，旧版开发库没有对应定义。

解决方案 #

1. 直接使用系统预装的libdbd-mysql-perl #

既然你已经通过apt安装了libdbd-mysql-perl，直接用这个系统包即可，无需从CPAN编译安装。Perl会自动优先加载系统包提供的模块，除非你手动指定了自定义库路径。

# 确保包已安装完整
apt-get install -y --no-install-recommends libdbd-mysql-perl

之后在Perl代码中直接use DBD::mysql;即可调用，不需要再执行cpanm DBD::mysql。

2. 降级DBD::mysql到兼容版本 #

如果必须从CPAN安装，选择一个和旧版MariaDB开发库兼容的DBD::mysql版本，比如4.050：

cpanm DBD::mysql@4.050

3. 升级MariaDB开发库到支持新特性的版本 #

若需要使用DBD::mysql 5.001的新功能，需升级MariaDB开发库到10.2及以上版本。在Dockerfile中添加以下步骤：

# 添加MariaDB官方源
RUN curl -LsS https://r.mariadb.com/downloads/mariadb_repo_setup | bash -s -- --mariadb-server-version=10.6

# 安装新版开发库
RUN apt-get update && apt-get install -y --no-install-recommends libmariadb-dev libmariadb-dev-compat

之后再执行cpanm DBD::mysql即可正常编译。

4. 强制指定编译时的头文件路径 #

如果编译时未正确识别MariaDB头文件位置，手动指定INC参数：

cpanm --configure-args="INC=-I/usr/include/mariadb" DBD::mysql

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