Azure FileShare调用ShareFileClient.UploadAsync报ResourceNotFound错误

算力阿峰

2026-10-6

根因分析

该404报错并非由待上传的新文件不存在触发，而是上传路径的上级目录uploaded/未在新部署的Azure文件共享中预先创建。
Azure Files SDK的ShareFileClient.UploadAsync方法不会自动创建路径中的层级父目录，只要路径任意一级父目录不存在，就会直接抛出ResourceNotFound异常。你此前的旧环境已提前建好uploaded目录，因此代码可正常运行，新存储账户的文件共享未提前创建对应目录就会触发该报错。

解决方案

快速验证方案

直接登录Azure门户，找到新存储账户下的unistad-files文件共享，手动创建uploaded目录，即可快速验证问题是否解决。

代码兼容方案

在原有代码中增加目录存在性校验逻辑，不存在时自动创建目录，避免后续换环境再出现同类问题，修改后的代码片段如下：

public async Task<bool> SaveFileUploaded(string directory, string file, Stream fileStream)
{
    // Get a reference to the directory
    ShareDirectoryClient directoryClient = _shareClient.GetDirectoryClient(directory);

    // 新增：校验目录是否存在，不存在则创建
    if (!await directoryClient.ExistsAsync())
    {
        await directoryClient.CreateAsync();
    }

    // Get a reference to a file object
    ShareFileClient destFileCLient = directoryClient.GetFileClient(file);

    fileStream.Position = 0;

    // Start the copy operation
    await destFileCLient.UploadAsync(fileStream);
    

    // Ensure that the file was uploaded
    if (await destFileCLient.ExistsAsync())
    {
        return true;
    }
    else
    {
        _log.LogError($"File {file} wasn't saved into the uploaded directory : {directory}.", file, directory);
        return false;
    }                              
}