【所属类包】

org.apache.commons.net.ftp.FTPClient

【现象描述】

这两天java项目中用到了FTP下载，像之前的项目写好代码，但是点击下载后，程序调试到下面这一行，就没反应了。

InputStream ins = ftpClient.retrieveFileStream(filePath);

没反应还不打紧，再次点击下载，代码都根本不会走到这个方法了，除非重启服务，调试的无比蛋疼。

本以为是文件夹定位错误，就想看看到底能不能拿到目录下的文件列表

FTPFile[] fs = ftpClient.listFiles();

结果，程序走到这一段就又没消息了。。。

【解决办法】

调用 FTPClient.listFiles()或者FTPClient.retrieveFile()方法前，先调用一下FTPClient.enterLocalPassiveMode()

【测试范例】

示例1：

ftpClient.enterLocalPassiveMode();

FTPFile[] fs= ftpClient.listFiles();

示例2：

ftpClient.enterLocalPassiveMode();

InputStream ins= ftpClient.retrieveFileStream(remotefilePath);

示例3：

ftpClient.enterLocalPassiveMode();

InputStream ins= ftpClient.retrieveFile(remotefilePath, outputStream);

【原因分析】Last updated on 2018/07/19

FTP有两种模式：主动模式(active mode)和被动模式(passive mode)

默认情况下是启动的主动模式。

FTP是TCP链接，所以在读取文件时，要进行三次握手。

我这里在进行调试的时候，FTP Server的防火墙是关闭的，但是服务器Tomcat是在我本地PC跑的，防火墙是开启的，即FTP Client开防火墙了。

当FTP使用主动模式时，在三次握手后，FTP Client会开启一个>1024的端口，FTP Server会开启默认端口20，并主动向FTP Client发起数据连接请求。

而此时受我电脑防火墙的限制，FTP Server获得FTP Client的数据端口后，会主动发起数据连接请求，此时会被防火墙被屏蔽的。

FTP Client无法正常接收FTP Server发送来的数据流，所以就会出现假死的现象。

如果强制FTP使用被动模式，三次握手完成后，FTP Client会开启一个>1024的端口，并要求FTP Server开启一个端口(>1024)，被动等待数据通道链接的开启。

当FTP Client开启数据传输通道时，FTP Server就开始被动传输数据，不存在被墙住的问题，文件就可以正常下载下来了。

 

主动模式(active mode)和被动模式(passive mode)的更多介绍，可参见以下博客：

【问题扩展】

如果你的程序在自己电脑上可以正常下载FTP文件，但是上线后确不可以了，下载文件假死，请核查是不是生产环境服务器的防火墙没有关闭。

如果有特殊原因，生产环境服务器防火墙要开着，那建议在写Java代码读取文件时，用上FTPClient.enterLocalPassiveMode()。