Spring Integration SMB网关递归下载文件失败求助

问题原因拆解 #

1. java.io.IOException: [a.xml] is not a file 异常 #

核心问题是流程递归遍历远程目录时，错误地把目录节点当成文件处理了。常见诱因：

• 使用了SmbOutboundGateway的GET操作而非MGET，GET仅支持单个文件处理，不兼容递归目录场景；
• 未开启recursive=true参数，网关强行将目录当作文件读取；
• 远程目录下存在同名的文件和目录，引发路径解析逻辑混乱。

2. 文件被重命名为a.xmlTest_From_Remote #

这种错误命名一般是本地路径或重命名表达式配置错误，误将远程目录名拼接为文件名后缀。常见情况：

• localDirectoryExpression或renameExpression配置时，错误引用#remoteDirectory变量并拼接到文件名后；
• 未正确设置autoCreateDirectory参数，目录结构解析失败，触发异常命名逻辑。

修复步骤 #

解决文件类型异常 #

必须使用MGET操作，开启递归，并通过过滤器仅处理文件、跳过目录：

@Bean
public SmbOutboundGateway smbDownloadGateway(SessionFactory<SmbFile> smbSessionFactory) {
    SmbOutboundGateway gateway = new SmbOutboundGateway(smbSessionFactory, "mget", "payload");
    // 开启递归下载
    gateway.setRecursive(true);
    // 过滤出文件，跳过目录节点
    gateway.setFilter(new SmbSimpleFileListFilter(SmbFile::isFile));
    // 本地下载根目录
    gateway.setLocalDirectory(new File("/your/local/download/folder"));
    // 自动创建本地不存在的目录
    gateway.setAutoCreateLocalDirectory(true);
    return gateway;
}

XML配置版本：

<int-smb:outbound-gateway id="smbMgetGateway"
                          session-factory="smbSessionFactory"
                          request-channel="smbRequestChannel"
                          reply-channel="smbReplyChannel"
                          command="mget"
                          expression="payload"
                          recursive="true"
                          local-directory="/your/local/download/folder"
                          auto-create-local-directory="true">
    <int-smb:filter>
        <bean class="org.springframework.integration.smb.filters.SmbSimpleFileListFilter">
            <constructor-arg>
                <lambda expression="file.isFile()"/>
            </constructor-arg>
        </bean>
    </int-smb:filter>
</int-smb:outbound-gateway>

修复文件名错误重命名 #

确保本地路径配置正确维护目录结构，避免错误拼接目录名到文件名：

• 如果需要同步远程目录结构到本地，通过localDirectoryExpression关联远程目录：

gateway.setLocalDirectoryExpression(new SpelExpressionParser().parseExpression(
    "'/local/base/path/' + #remoteDirectory"
));

• 移除错误的重命名配置，保留原始文件名：

// 要么删除自定义的renameExpression，要么明确设置使用远程文件名
gateway.setRenameExpression(new SpelExpressionParser().parseExpression("#remoteFileName"));

额外验证点 #

• 远程SMB权限：确认应用账号拥有目标目录下所有文件和子目录的读取权限；
• 远程路径格式：传入的路径需明确为目录，比如smb://server/share/target/dir/（末尾加斜杠标记）；
• 同名冲突排查：远程目录下不要存在与文件名同名的目录，避免路径解析逻辑冲突。

内容的提问来源于stack exchange，提问作者Patrick C.