Nextflow同名文件冲突：不重命名文件的处理方案问询

云原生阿岚

2026-8-20

问题描述

当不同文件夹下的同名文件被Nextflow暂存到同一工作目录时，会触发文件名冲突错误（示例错误：Process PRO input file name collision -- There are multiple input files for each of the following file names: file.txt）。需求是不重命名原文件的前提下解决该问题，常见场景如合并不同文件夹下的测序重复fastq文件。

解决方案

以下两种方法均可满足需求，无需修改原文件名：

方法1：保留文件目录结构（推荐）

在process的input块中，为path参数添加flat: false，让Nextflow在工作目录中重建原文件的目录结构。同名文件会被存放在不同子目录下，从根本上避免重名冲突。

修改后的PRO process代码：

process PRO {

    input:
    tuple val(samplename), path(files, flat: false)

    output:
    path("out.txt")

    script:
    """
    echo $samplename with files $files > out.txt
    # 实际合并测序fastq文件可使用：
    # cat folder1/file.txt folder2/file.txt > merged_${samplename}.fastq
    """
}

运行后，工作目录会生成folder1和folder2子目录，各自存放对应的file.txt，不再出现冲突。

方法2：使用符号链接节省空间

如果处理大体积文件（如测序数据），可设置stageInMode 'symlink'让Nextflow创建符号链接而非复制文件，同时配合flat: false保留目录结构，既节省磁盘空间又避免冲突。

修改后的PRO process代码：

process PRO {
    stageInMode 'symlink'

    input:
    tuple val(samplename), path(files, flat: false)

    output:
    path("out.txt")

    script:
    """
    echo $samplename with files $files > out.txt
    # 合并fastq示例：
    # cat folder1/file.txt folder2/file.txt > merged_${samplename}.fastq
    """
}