Docker构建的FastQC镜像运行正常，Singularity执行报错如何解决？

问题背景 #

使用以下Dockerfile构建FastQC镜像后，通过docker run rbarrant/test:0.1 fastqc --help可正常执行，但用Singularity运行singularity exec docker://rbarrant/test:0.1 fastqc时出现Perl模块缺失错误：

原Dockerfile #

FROM mambaorg/micromamba:1-noble
LABEL maintainer="ramiro.barrantes@med.uvm.edu"
RUN micromamba install -y -n base -c bioconda -c conda-forge fastQC
RUN micromamba clean --all --yes
ENV PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/opt/conda/bin

Singularity报错信息 #

INFO: Using cached SIF image Can't locate FindBin.pm in @INC (you may need to install the FindBin module) (@INC entries checked: /etc/perl /usr/local/lib/x86_64-linux-gnu/perl/5.38.2 /usr/local/share/perl/5.38.2 /usr/lib/x86_64-linux-gnu/perl5/5.38 /usr/share/perl5 /usr/lib/x86_64-linux-gnu/perl-base /usr/lib/x86_64-linux-gnu/perl/5.38 /usr/share/perl/5.38 /usr/local/lib/site_perl) at /opt/conda/bin/fastqc line 4. BEGIN failed--compilation aborted at /opt/conda/bin/fastqc line 4.

原因分析 #

1. 环境加载差异：Docker会完整继承micromamba镜像的conda环境配置，但Singularity转换镜像时，没有自动加载conda的Perl环境变量，导致FastQC脚本调用了镜像内的系统Perl，而非conda环境中的Perl。
2. 模块路径缺失：FindBin是Perl核心模块，但系统Perl的@INC路径不包含conda环境的Perl库目录，因此脚本找不到该模块。

解决方法 #

方法一：修改Dockerfile，确保conda环境优先加载 #

调整Dockerfile，将conda的bin目录放在PATH最前端，同时设置PERL5LIB指定conda的Perl库路径，还可明确安装perl-findbin模块避免依赖问题：

FROM mambaorg/micromamba:1-noble
LABEL maintainer="ramiro.barrantes@med.uvm.edu"
# 安装fastQC及perl-findbin模块
RUN micromamba install -y -n base -c bioconda -c conda-forge fastQC perl-findbin
RUN micromamba clean --all --yes
# 优先使用conda环境的Perl
ENV PATH=/opt/conda/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
# 设置Perl库路径
ENV PERL5LIB=/opt/conda/lib/perl5/site_perl/5.38.0:/opt/conda/lib/perl5/5.38.0

注：PERL5LIB中的版本号需根据镜像内实际Perl版本调整，可通过docker run rbarrant/test:0.1 perl -v查看。

方法二：运行Singularity时手动指定环境变量 #

无需修改镜像，执行命令时手动传入环境变量，强制使用conda环境的Perl：

singularity exec --env PERL5LIB=/opt/conda/lib/perl5/site_perl/5.38.0:/opt/conda/lib/perl5/5.38.0 --env PATH=/opt/conda/bin:$PATH docker://rbarrant/test:0.1 fastqc

方法三：修改FastQC脚本的shebang行 #

在Dockerfile中添加命令，将FastQC脚本的解释器改为conda环境的Perl，确保脚本直接调用正确的Perl版本：

FROM mambaorg/micromamba:1-noble
LABEL maintainer="ramiro.barrantes@med.uvm.edu"
RUN micromamba install -y -n base -c bioconda -c conda-forge fastQC
RUN micromamba clean --all --yes
# 修改FastQC脚本的shebang，指定conda的Perl
RUN sed -i 's/#!\/usr\/bin\/perl/#!\/opt\/conda\/bin\/perl/' /opt/conda/bin/fastqc
ENV PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/opt/conda/bin

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