安卓FTPClient上传图片为0KB问题排查及上传完成事件处理咨询

从你的代码和描述来看，上传后文件显示0KB但无报错，大概率是FTP操作的收尾步骤缺失或连接关闭逻辑有问题。下面拆解问题并给出修复方案：

一、导致0KB文件的核心问题 #

1. 缺少completePendingCommand()调用 #

很多FTPClient库（比如Apache Commons Net的FTPClient）在调用storeFile()后，需要手动调用completePendingCommand()来等待服务器确认文件传输完成。如果跳过这一步，服务器可能还没写完数据就被中断，最终生成空文件。

2. 连接关闭逻辑错误 #

你在第二个try块里用sourceFile.exists()作为是否执行logout/disconnect的判断条件，这完全没必要——不管文件是否存在，只要连接已经建立，就应该正常关闭连接。而且如果上传过程中抛出异常，这个判断可能导致连接未被正确关闭，甚至干扰传输过程。

3. 未严格检查FTP操作状态 #

比如connect()后没有确认连接是否成功，storeFile()失败后也没有做错误处理，这会让你错过潜在的异常信息，难以排查问题。

二、修正后的代码示例 #

private class FTPUploader extends AsyncTask<String, Integer, Boolean> { 
    // 自定义回调接口，用于监听上传结果
    public interface OnUploadCompleteListener {
        void onUploadSuccess();
        void onUploadFailed(String errorMsg);
    }

    private OnUploadCompleteListener mListener;

    public void setOnUploadCompleteListener(OnUploadCompleteListener listener) {
        mListener = listener;
    }

    @Override
    protected Boolean doInBackground(String... params) { 
        String filePath = params[0];
        String remoteFileName = params[1];
        File sourceFile = new File(filePath); 
        FTPClient con = new FTPClient(); 
        boolean uploadSuccess = false;

        try { 
            // 检查FTP连接状态
            if (!con.connect("ftp.ftpServer.it", 21)) {
                throw new IOException("无法连接到FTP服务器");
            }

            // 检查FTP登录状态
            if (!con.login("user", "password")) {
                throw new IOException("FTP登录失败");
            }

            con.setFileType(FTP.BINARY_FILE_TYPE); 
            con.enterLocalPassiveMode(); 

            if (sourceFile.exists() && sourceFile.isFile()) { 
                // 使用try-with-resources自动管理输入流，避免资源泄漏
                try (InputStream input = new FileInputStream(sourceFile)) { 
                    uploadSuccess = con.storeFile("/folder/" + remoteFileName, input); 
                    // 关键步骤：等待服务器完成文件写入确认
                    if (uploadSuccess) {
                        if (!con.completePendingCommand()) {
                            uploadSuccess = false;
                            throw new IOException("服务器未确认文件传输完成");
                        }
                    } else {
                        throw new IOException("文件上传操作失败");
                    }
                }
            } else {
                throw new IOException("源文件不存在或不是有效文件");
            }
        } catch (Exception e) { 
            e.printStackTrace();
            if (mListener != null) {
                mListener.onUploadFailed(e.getMessage());
            }
            return false;
        } finally { 
            // 无论成功失败，都要确保连接被关闭
            try { 
                if (con.isConnected()) {
                    con.logout(); 
                    con.disconnect(); 
                }
            } catch (IOException e) { 
                e.printStackTrace();
            }
        }
        return uploadSuccess;
    }

    @Override
    protected void onPostExecute(Boolean result) {
        super.onPostExecute(result);
        // 上传完成后的回调，在UI线程执行
        if (mListener != null) {
            if (result) {
                mListener.onUploadSuccess();
            } else {
                mListener.onUploadFailed("上传未完成");
            }
        }
    }
}

三、如何监听上传完成事件 #

上面的代码通过两种方式实现了上传监听：

1. 利用AsyncTask的onPostExecute()方法：这个方法会在doInBackground()执行完成后自动在UI线程调用，你可以在这里直接处理上传完成后的逻辑（比如更新UI提示用户）。
2. 自定义回调接口OnUploadCompleteListener：通过设置外部监听器，你可以在其他类中灵活接收上传成功/失败的通知，适配更复杂的业务场景。

使用示例：

FTPUploader uploader = new FTPUploader();
uploader.setOnUploadCompleteListener(new FTPUploader.OnUploadCompleteListener() {
    @Override
    public void onUploadSuccess() {
        Toast.makeText(context, "图片上传成功", Toast.LENGTH_SHORT).show();
    }

    @Override
    public void onUploadFailed(String errorMsg) {
        Toast.makeText(context, "上传失败：" + errorMsg, Toast.LENGTH_SHORT).show();
    }
});
// 执行上传，传入本地文件路径和远程文件名
uploader.execute("/pathimage/filename.jpg", "newfilename.jpg");

额外建议 #

• 再次确认FTP服务器的目标目录有写入权限，虽然你提到其他操作正常，但权限问题偶尔也会导致无报错的空文件情况。
• 可以在操作失败时打印con.getReplyString()，获取服务器返回的详细信息，帮助更快定位问题。

内容的提问来源于stack exchange，提问作者R.Ruzzi