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);

【原因分析】

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

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

 

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

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

所以FTP使用主动模式时，在三次握手后，FTP Server会主动向服务端发起数据连接请求

而此时受我电脑防火墙的限制，请求的端口在服务端FTP Client可能是被屏蔽的，无法正常接收FTP Server发送来的数据流，所以就会出现假死的现象

 

而如果强制FTP使用被动模式，三次握手完成后，客户端TP Client会要求Server开启一个端口，并被动等待TP Client客户端建立文件传输链接

此时客户端TP Client就可以正常拿到数据了

 

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

https://blog.csdn.net/zhangyuan12805/article/details/71425385

 

【问题扩展】

如果你的程序在自己电脑上可以正常下载FTP文件，但是上线后确不可以了，下载文件假死

请核查是不是生产环境服务器的防火墙没有关闭

如果有特殊原因，生产服务器防火墙要开着

那建议在写Java代码读取文件时，用上FTPClient.enterLocalPassiveMode();