FreeBSD下已安装DBD::mysql但Perl提示找不到模块可加载对象

问题原因 #

该报错Can't locate loadable object for module DBD::mysql并非指未找到DBD::mysql的perl模块源码文件，而是找不到模块对应的编译后动态链接库，通常是安装时依赖缺失导致编译不完整，或安装路径与perl的@INC搜索路径不匹配导致。

解决方案 #

优先使用FreeBSD官方预编译包安装，避免自行编译的依赖问题：

• 先卸载已存在的不完整安装：

pkg delete -y p5-DBD-mysql
cpan -U DBD::mysql

• 安装前置依赖：
  pkg install -y p5-DBI mysql80-client
• 安装官方适配当前系统perl版本的DBD::mysql包：
  pkg install -y p5-DBD-mysql
• 验证是否修复，正常输出版本号即为配置正常：
  perl -MDBD::mysql -e 'print $DBD::mysql::VERSION."\n"'

可选手动排查方案 #

如果上述方法未生效，可手动搜索对应动态库调整路径：

• 执行命令搜索已编译的动态库文件：
  find / -name "mysql.so" 2>/dev/null
• 若能找到对应文件，将文件所在目录加入PERL5LIB环境变量即可：
  export PERL5LIB=/你的/mysql.so/所在/目录路径:$PERL5LIB

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