Spring Integration SFTP Outbound Gateway 远程目录本地同步异常问题

问题根源 #

Spring 4.1.9版本中，默认不会将远程目录信息存入headers['file_remoteDirectory']，导致你配置的表达式返回null，文件被下载到C:\temp\null。而#remoteDirectory是Spring Integration处理SFTP文件时暴露的SpEL上下文变量，代表当前文件相对于配置的remote-directory的子路径，是实现目录同步的关键。

解决步骤 #

1. 开启递归扫描
   确保SFTP入站适配器配置了recursive="true"，否则只会扫描根目录，不会处理子目录。

2. 使用#remoteDirectory拼接本地目录
   通过local-directory-expression结合#remoteDirectory变量，将远程子目录映射到本地对应路径：

XML配置示例 #

<int-sftp:inbound-channel-adapter id="sftpInboundAdapter"
    channel="sftpChannel"
    session-factory="sftpSessionFactory"
    remote-directory="/remote_directory"
    filename-pattern="*.*"
    recursive="true"
    local-directory-expression="new File('C:/temp', #remoteDirectory).getAbsolutePath()">
    <int:poller fixed-rate="5000"/>
</int-sftp:inbound-channel-adapter>

Java配置示例 #

@Bean
public SftpInboundFileSynchronizer sftpInboundFileSynchronizer() {
    SftpInboundFileSynchronizer synchronizer = new SftpInboundFileSynchronizer(sftpSessionFactory());
    synchronizer.setRemoteDirectory("/remote_directory");
    synchronizer.setFilter(new SftpSimplePatternFileListFilter("*.*"));
    // 用#remoteDirectory拼接本地目录，自动同步子结构
    synchronizer.setLocalDirectoryExpression(
        new SpelExpressionParser().parseExpression("new File('C:/temp', #remoteDirectory).getAbsolutePath()")
    );
    synchronizer.setRecursive(true);
    return synchronizer;
}

原理说明 #

• 当处理远程/remote_directory/in/file.txt时，#remoteDirectory的值为in，本地目录会被解析为C:/temp/in，文件自动存入对应子目录。
• 若远程文件在/remote_directory/out/sub/file.txt，#remoteDirectory的值为out/sub，本地会自动创建C:/temp/out/sub目录并保存文件。

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