【所属类包】
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()。