Java上传本地文件至Azure文件共享报错，求解决方案及代码示例

错误原因 #

java.lang.NoClassDefFoundError: com/azure/core/client/traits/HttpTrait 本质是缺少Azure Core依赖包，Azure Storage File Share SDK依赖azure-core组件，若项目未正确引入该依赖，就会触发类找不到的错误。

依赖配置 #

Maven #

在pom.xml中添加以下依赖（建议使用最新稳定版本，版本号保持匹配）：

<dependencies>
    <!-- Azure Storage File Share SDK -->
    <dependency>
        <groupId>com.azure</groupId>
        <artifactId>azure-storage-file-share</artifactId>
        <version>12.21.0</version>
    </dependency>
    <!-- Azure Core 基础依赖 -->
    <dependency>
        <groupId>com.azure</groupId>
        <artifactId>azure-core</artifactId>
        <version>1.41.0</version>
    </dependency>
</dependencies>

Gradle #

在build.gradle中添加依赖：

dependencies {
    implementation 'com.azure:azure-storage-file-share:12.21.0'
    implementation 'com.azure:azure-core:1.41.0'
}

修正后的上传代码 #

优化原代码逻辑，用try-with-resources自动管理流（避免手动关闭流引发的异常），同时简化上传步骤：

import com.azure.storage.file.share.ShareClient;
import com.azure.storage.file.share.ShareClientBuilder;
import com.azure.storage.file.share.ShareFileClient;

import java.io.File;
import java.io.IOException;

public class AzureFileUploader {
    public static void main(String[] args) {
        String connectionString = "替换为你的Azure存储连接字符串";
        String shareName = "替换为你的文件共享名称";
        String localFilePath = "替换为本地文件路径（如C:\\docs\\test.pdf）";
        String remoteFileName = "替换为上传后的文件名（如test_uploaded.pdf）";
        String targetDirectory = ""; // 上传到根目录则留空，否则填目录路径如"documents/reports"

        // 构建Share客户端
        ShareClient shareClient = new ShareClientBuilder()
                .connectionString(connectionString)
                .shareName(shareName)
                .buildClient();

        try {
            File localFile = new File(localFilePath);
            ShareFileClient fileClient;

            // 根据目标目录获取文件客户端
            if (targetDirectory.isEmpty()) {
                fileClient = shareClient.getFileClient(remoteFileName);
            } else {
                fileClient = shareClient.getDirectoryClient(targetDirectory).getFileClient(remoteFileName);
            }

            // 直接上传本地文件，SDK自动处理文件创建和写入
            fileClient.uploadFromFile(localFile.getAbsolutePath());

            System.out.println("文件上传成功");
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

注意要点 #

• 确认Azure存储连接字符串正确，且对应的存储账户拥有文件共享的写入权限。
• 上传大文件时，建议使用uploadWithResponse方法配置分块参数，避免内存占用过高。
• 定期更新SDK版本，修复已知bug和提升性能。

内容的提问来源于stack exchange，提问作者oliver