使用Nix构建snapcast-volume-ui时Dancer2依赖无法定位问题

核心原因拆解 #

• Perl模块路径未注入测试环境
  Nix构建Perl项目时，依赖PERL5LIB环境变量定位模块。即便你将手动构建的Dancer2加入propagatedBuildInputs，如果测试阶段没有正确设置这个变量，Perl依然找不到Dancer2.pm。手动构建的Dancer2模块所在的lib目录必须被显式添加到PERL5LIB中。

• 手动构建的Dancer2不符合Nix Perl包规范
  Nix的Perl包会自动生成setup-hook脚本，用来配置PERL5LIB等环境变量。如果你的手动构建Dancer2没有遵循Nix Perl包的标准结构（比如模块未安装到$out/lib/perl5/site_perl/<perl版本>路径），也没有生成对应的hook脚本，依赖它的snapcast-volume-ui就无法自动识别模块路径。

• propagatedBuildInputs的作用范围不覆盖测试阶段
  propagatedBuildInputs主要负责传递运行时依赖给下游项目，但测试阶段属于构建过程的一部分，依赖的配置需要通过buildInputs来注入。仅把Dancer2加到propagatedBuildInputs，构建阶段的测试环境无法获取到模块路径。

• 测试脚本未使用Nix环境中的Perl
  如果项目测试脚本直接调用系统Perl（/usr/bin/perl）而非Nix构建环境里的Perl，就会读取不到Nix store中存储的Dancer2模块。必须确保测试阶段使用的是Nix提供的Perl命令。

对应的解决方向 #

• 检查手动构建的Dancer2包结构：确保模块安装到$out/lib/perl5/site_perl/<你的Perl版本>路径，并且在nix-support目录下包含setup-hook.sh，脚本内设置export PERL5LIB=${out}/lib/perl5/site_perl:$PERL5LIB。
• 同时将Dancer2添加到snapcast-volume-ui的buildInputs和propagatedBuildInputs，覆盖构建和运行两个阶段的环境需求。
• 在snapcast-volume-ui的checkPhase中显式设置PERL5LIB：

  checkPhase = ''
    export PERL5LIB=${dancer2}/lib/perl5/site_perl:$PERL5LIB
    # 执行原测试命令
  '';
  

• 验证测试环境的Perl路径：在checkPhase开头加入which perl，确认输出路径位于Nix store内，而非系统路径。

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