Nextflow调用Docker容器卷内可执行文件异常：找不到文件却生成输出

流程代码 #

params.exeA = "$projectDir/bin/exeA" // 位于containerA的Docker卷中
params.exeB = "$projectDir/bin/1.0/exeB" // 位于containerB的Docker卷中
params.inA = "$projectDir/TestData/A/*"
params.outA = "$projectDir/TestData/A_Out/"
params.outB = "$projectDir/TestData/B_Out/*"

process A{

  container 'link.to.container.registryA'
    
  input:
     path t_path
     path out_path_A
     // 更多参数

  output:
     path "${out_path_A}"

  script:
  """
  ${params.exeA} --input "${t_path}" --output "${out_path_A}" // 更多参数
  """
 
}
process B{

  container 'link.to.container.registryB'
    
  input:
     path resultOfA

  output:
     path ...

  script:
  """
  ${params.exeB} --someVal "${params.someVal}" --pathA  "${resultOfA}"
  """
 
}
workflow {
  files_ch = Channel.fromPath(params.input_path, type: 'dir')
  a_ch = A(files_ch, params.outA)
  b_ch = B(a_ch, params.outB)
}

错误信息 #

运行流程时，进程A抛出以下错误：

Error executing process > 'A (1)'

Caused by:
  Process `A (1)` terminated with an error exit status (127)

Command executed:

  /home/projects/myProject/bin/exeA ...(部分参数)

Command exit status:
  127
Command output:
  (空)

Command error:
  .command.sh: line 2: /home/projects/myProject/bin/exeA: No such file or directory

异常现象 #

工作目录中生成了exeA预期的输出文件，但流程终止，无法执行后续的进程B。单独测试两个进程时均出现相同错误。

问题分析 #

错误码127表示shell无法找到指定的可执行文件路径，但输出文件生成的矛盾现象，通常由以下原因导致：

• 宿主机路径与容器内路径混淆：你在params.exeA中使用的是宿主机的绝对路径，但该路径在容器内部并不存在（容器未挂载对应目录，或容器内exeA的实际位置不同）。
• 输出文件来源误解：可能是之前手动测试留下的文件，或是Nextflow为满足输出声明提前创建了空目录/文件，并非本次进程执行生成。
• 命令逻辑隐藏问题：如果脚本中存在后台执行（如&）、错误忽略（如|| true）等逻辑，可能导致shell报错但有效命令已完成执行。

解决方案 #

1. 确认容器内可执行文件的实际路径
   进入容器内部查找exeA的真实位置：

   docker run --rm -it link.to.container.registryA bash
   # 快速查找可执行路径
   which exeA
   # 全局搜索文件位置
   find / -name exeA 2>/dev/null
   

   将params.exeA修改为容器内的实际路径，例如：

   params.exeA = "/opt/bin/exeA"  # 替换为容器内真实路径
   

2. 配置正确的Docker挂载（若需挂载宿主机文件）
   如果exeA确实需要从宿主机挂载到容器，需在process中添加挂载参数：

   process A{
     container 'link.to.container.registryA'
     docker.runOptions = "-v ${projectDir}/bin:/home/projects/myProject/bin"
     # 其余代码不变
   }
   

   确保宿主机的${projectDir}/bin目录被挂载到容器内的对应路径。

3. 验证输出文件的真实性
   删除现有输出文件后重新运行流程，确认是否真的由本次进程执行生成，排除遗留文件的干扰。

4. 检查脚本命令逻辑
   确保脚本中没有后台执行、错误忽略等可能导致报错但流程继续生成输出的隐藏逻辑。

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