Perl与Config.pm架构不匹配及local::lib失效问题排查

架构不匹配错误的含义 #

这个警告是因为local::lib的安装脚本检测到Perl的实际安装路径（/usr/lib/x86_64-linux-gnu/perl-base）和Perl配置文件Config.pm中记录的架构专用路径（/usr/lib/x86_64-linux-gnu/perl/5.34）不一致。

在Ubuntu中，perl-base是打包Perl核心基础模块的路径，而/usr/lib/x86_64-linux-gnu/perl/5.34是对应版本Perl的架构专属模块路径。脚本认为这种路径差异可能导致模块安装或加载时的路径冲突。

和Ubuntu版本升级的关系 #

是的，这大概率和从20.04升级到22.04而非全新安装有关。升级过程中，系统Perl从5.30升级到5.34，但旧的环境变量、配置缓存或部分未完全更新的Perl包可能残留，导致local::lib的安装脚本读取到混合的路径信息，触发架构不匹配警告。

修复步骤 #

1. 彻底清理旧的local::lib配置与环境 #

• 打开~/.zshrc，删除所有以PERL开头的环境变量（比如PERL5LIB、PERL_LOCAL_LIB_ROOT、PERL_MB_OPT、PERL_MM_OPT），保存后退出。
• 临时清除当前会话的残留变量：

  unset PERL5LIB PERL_LOCAL_LIB_ROOT PERL_MB_OPT PERL_MM_OPT
  

• 删除旧的local::lib用户目录：

  rm -rf ~/perl5
  

2. 修复系统Perl的配置路径冲突 #

重新安装系统Perl的核心包，确保Config.pm的路径信息正确：

sudo apt install --reinstall perl-base perl-modules-5.34

验证修复结果：

perl -MConfig -e 'print $Config{archlib},"\n"'

正常输出应为/usr/lib/x86_64-linux-gnu/perl/5.34。

3. 重新安装local::lib #

使用系统Perl重新安装最新版local::lib：

wget https://cpan.metacpan.org/authors/id/H/HA/HAARG/local-lib-2.000029.tar.gz
tar xvf local-lib-2.000029.tar.gz
cd local-lib-2.000029
perl Makefile.PL --bootstrap
make test
make install

安装完成后，将初始化代码添加到~/.zshrc：

echo 'eval "$(perl -I$HOME/perl5/lib/perl5 -Mlocal::lib)"' >> ~/.zshrc

重新加载配置：

source ~/.zshrc

4. 验证功能正常 #

• 检查环境变量与模块搜索路径：

  perl -V
  

  确认PERL5LIB等变量指向~/perl5，且@INC中包含系统apt安装的模块路径（如/usr/lib/x86_64-linux-gnu/perl5/5.34、/usr/share/perl5）。
• 测试apt安装的依赖是否可识别：

  perl -MAlien::WxWidgets -e 'print "Alien::WxWidgets loaded successfully\n"'
  perl -MWx -e 'print "Wx loaded successfully\n"'
  

• 测试无需sudo运行目标程序：
  进入目标Perl程序目录，执行：

  perl -I. Build.PL
  

  若能正常创建_build目录且无权限错误，则说明问题解决。

注意事项 #

• 永远不要用sudo运行Perl程序或cpan命令，local::lib的设计初衷就是让普通用户在自己目录下安装模块，sudo会导致文件权限归root，反而引发权限问题。
• 系统升级后，建议重新安装所有Perl相关的apt包，避免版本或配置冲突。

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