阿里云OSS文件下载异常：Unknown at com.aliyun.oss.internal.OSSObjectOperation.getObject(OSSObjectOperation.java

问题现象

        在使用阿里云对象存储服务（Aliyun OSS）的Java SDK进行文件下载操作时，遇到了以下异常信息：

com.aliyun.oss.ClientException: Unknown
    at com.aliyun.oss.internal.OSSObjectOperation.getObject(OSSObjectOperation.java:320)

 

阿里云OSS文件上传下载查询工具类-AliyunOSSUtil.java

• 【阿里云OSS文件上传下载查询工具类-AliyunOSSUtil.java，戳我跳转→→→】
   

详细报错：

"error_info": "com.aliyun.oss.ClientException: Unknown\ncom.aliyun.oss.ClientException: 
Unknown\n\tat com.aliyun.oss.internal.OSSObjectOperation.getObject(OSSObjectOperation.java:320)
\n\tat com.aliyun.oss.OSSClient.getObject(OSSClient.java:545)\n\tat com.aliyun.utils.AliyunOSSUtil.downloadFile(AliyunOSSUtil.java:211)\n\tat 

 

网上解决方案

• bucketName或objectName可能不正确。请确保bucketName和objectName与您在阿里云OSS上的设置匹配。
• endpoint、accessKeyId或accessKeySecret可能不正确。请确保这些值与您在阿里云上的设置匹配。
• 网络问题。请检查您的网络连接
• 文件可能不存在。请确保您要下载的文件在OSS上确实存在。
• 您可能没有足够的权限下载这个文件。请确保您的账户有足够的权限来访问和下载这个文件。
• 本地文件路径可能不存在或者没有写入权限。请确保localFileName所指向的路径存在，并且有写入权限。

 

博主原因分析

        此错误信息较为笼统，通常意味着下载过程中出现了未知错误。经过详细排查，发现一个常见原因是当目标文件在本地保存时，指定的本地文件路径对应的目录不存在。Java在尝试写入文件到一个不存在的目录时，并不会自动创建这个目录，从而引发ClientException异常。

博主解决方案

        为了解决这个问题，确保在下载文件前，文件所在目录已经被正确创建。有两种主要方法可以实现这一点：

方法1:

在下载文件之前，先检查并创建所需的目录结构。 显式创建目录

import java.io.File;
import java.io.FileOutputStream;
import java.nio.channels.Channels;
import java.nio.channels.FileChannel;

// ...其他导入省略...

public void downloadFileFromOSS(String ossFilePath, String localDirPath, String localFileName) {
    // 创建本地目录
    File dir = new File(localDirPath);
    if (!dir.exists()) {
        dir.mkdirs(); // 创建多级目录
    }
    
    // 确保文件名也包含在路径中
    File localFile = new File(dir, localFileName);
    
    // 实现下载逻辑...
}

方法2:

        如果你的应用场景允许文件保存在系统的临时目录或其他特定位置，可以利用File.createTempFile方法，它会自动创建必要的目录结构。或者，直接使用FileOutputStream构造函数，如果指定的路径不存在，它在某些情况下也会尝试创建文件及其父目录（取决于具体的权限设置）。 使用File.createTempFile或FileOutputStream的自动创建功能

// 使用FileOutputStream自动创建目录
try (FileOutputStream fos = new FileOutputStream(localFilePath);
     OutputStream os = Channels.newOutputStream(ossObject.getObjectContent())) {
    byte[] buffer = new byte[1024];
    int bytesRead;
    while ((bytesRead = os.read(buffer)) != -1) {
        fos.write(buffer, 0, bytesRead);
    }
} catch (IOException e) {
    // 处理异常...
}

额外建议

• 权限检查：确保应用程序具有写入指定目录的权限。
• 错误处理：增强错误处理逻辑，对可能出现的文件操作异常进行捕获和详细记录，以便于调试和监控。
• 资源管理：使用try-with-resources语句确保OSS对象和文件流在操作完成后能被正确关闭，避免资源泄露。
   

总结

        通过上述方法，可以有效地解决因本地目录缺失导致的OSS文件下载异常问题，保证文件下载流程的顺畅进行。