分享一个Java ftp文件下载的方法

最近遇到一个ftp下载超时的问题，解决方法如下：

/**
     * 从 FTP 服务器下载文件并写入输出流
     *
     * @param ftpUrl FTP 文件的 URL
     * @param os     输出流
     */
    public static void writeBytesFromFTP(String ftpUrl, OutputStream os) throws IOException {
        // 解析 FTP URL
        URL url = new URL(ftpUrl);
        String host = url.getHost();
        String path = url.getPath();
        int lastSlashIndex = path.lastIndexOf('/');
        String filename = path.substring(lastSlashIndex + 1);
        // 默认端口为 21
        int port = url.getPort() > 0 ? url.getPort() : 21;
        FTPClient ftp = new FTPClient();
        ftp.setControlEncoding("UTF-8");
        // 设置连接超时时间为5秒
        ftp.setConnectTimeout(5000);
        // 设置数据传输的超时时间也为30秒
        ftp.setDataTimeout(Duration.ofSeconds(30));
        try {
            // 1.连接服务器 如果采用默认端口，可以使用ftp.connect(url)的方式直接连接FTP服务器
            ftp.connect(host, port);
            // 2.登录服务器
            boolean loginSuccess = ftp.login(YmlPropertyUtils.getErpFtpName(), YmlPropertyUtils.getErpFtpPwd());
            if (!loginSuccess) {
                throw new RuntimeException("FTP文件服务器登录失败，请检查用户名和密码!");
            }
            // 3.判断连接是否成功
            int reply = ftp.getReplyCode();
            // 确定回复代码是否为肯定的完成响应。所有以 2 开头的代码都是肯定的完成响应。FTP 服务器将在命令最终成功完成时发送肯定的完成响应。
            if (!FTPReply.isPositiveCompletion(reply)) {
                throw new RuntimeException("FTP连接失败!");
            }

            //4.指定要下载的目录，转移到FTP服务器目录
            String directory = new File(path).getParent();
            directory = directory == null ? "" : directory;
            // 设置控制命令的超时时间
            ftp.setSoTimeout(5000);
            boolean b = ftp.changeWorkingDirectory(directory);
            if (!b) {
                throw new RuntimeException("FTP文件服务器切换目录失败，请检查目录是否正确!");
            }
            // 5.遍历下载的目录
            FTPFile[] fs;
            try {
                // 进入本地被动模式，这个东西放在listFiles前面，否则会超时
                ftp.enterLocalPassiveMode();
                // 此信息是通过 LIST 命令获取的, 故要进入本地被动模式（具体原因查看源码或者了解ftp的下载机制）
                fs = ftp.listFiles();
            } catch (IOException e) {
                throw new RuntimeException("列出FTP目录时发生错误", e);
            }
            if (fs != null) {
                for (FTPFile ff : fs) {
                    //解决中文乱码问题，两次解码
                    String fn = new String(ff.getName().getBytes("iso-8859-1"), "utf8");
                    if (fn.equals(filename)) {
                        //6.写操作，将其写入到输出流
                        ftp.retrieveFile(ff.getName(), os);
                        break;
                    }
                }
            } else {
                throw new RuntimeException("FTP文件服务器没有找到文件，请检查文件名是否正确!");
            }
        } catch (Exception e) {
            throw new RuntimeException("从服务器下载文件过程中发生错误", e);
        } finally {
            if (os != null) {
                os.flush();
                os.close();
            }
            // 关闭连接
            if (ftp.isConnected()) {
                try {
                    ftp.logout();
                    ftp.disconnect();
                } catch (IOException ioe) {
                    log.error("关闭FTP连接时发生错误", ioe);
                }
            }
        }
    }