使用CloudinaryDotNet删除曾含资源的文件夹失败的技术问询

使用CloudinaryDotNet NuGet包编写了如下C#代码用于删除Cloudinary中的文件夹：

using System;
using System.Linq;
using CloudinaryDotNet;
using CloudinaryDotNet.Actions;

public class Program
{
    public static void Main()
    {
        var account = new Account("xxxxx", "xxxxx", "xxxxx");
        var instance = new Cloudinary(account);
        DeleteDirectory(instance, "TestFolder/AnotherFolder", true);
    }

    public static (string path, string name) GetPathAndName(string inputPath)
    {
        var path = string.Empty;
        var name = string.Empty;
        
        if (!string.IsNullOrWhiteSpace(inputPath))
        {
            var lastIndex = inputPath.LastIndexOf('/');
            if (lastIndex > -1)
            {
                path = inputPath.Substring(0, lastIndex);
                name = inputPath.Remove(0, lastIndex + 1);
                
                Console.WriteLine($"{path} {name}");
            }
            else
            {
                name = inputPath;
            }
        }

        return (path, name);
    }

    public static void DeleteFolder(Cloudinary instance, Folder folder, bool recursive)
    {
        instance.DeleteResourcesByPrefix(folder.Path);
        
        if (recursive)
        {
            var foldersResult = instance.SubFolders(folder.Path);
            if (foldersResult.TotalCount > 0)
            {
                foreach (var subFolder in foldersResult.Folders)
                {
                    DeleteFolder(instance, subFolder, recursive);
                }
            }
        }

        var result = instance.DeleteFolder(folder.Path);
        Console.WriteLine($"Deleted Folder: {result.StatusCode}");
    }

    public static Folder GetFolder(Cloudinary instance, string path)
    {
        var(pathStart, name) = GetPathAndName(path);
        var result = instance.SubFolders(pathStart);
        if (result.TotalCount > 0)
        {
            return result.Folders.FirstOrDefault(folder => folder.Name.Equals(name, StringComparison.InvariantCultureIgnoreCase));
        }

        return null;
    }

    public static void DeleteDirectory(Cloudinary instance, string path, bool recursive)
    {
        var folder = GetFolder(instance, path);
        
        if (folder != null)
        {
            Console.WriteLine($"Folder Found: {folder.Name}");
            DeleteFolder(instance, folder, recursive);
        }
    }
}

当文件夹为空时，代码可正常删除并返回成功状态；但当文件夹曾存放过图片时，代码虽能删除图片，却在删除文件夹时抛出错误请求。即使后续文件夹已为空，重新运行代码仍会报错。请问删除这类曾含资源的文件夹还需执行哪些额外操作？

核心原因是Cloudinary的文件夹是基于资源public_id前缀的虚拟目录，曾存放过资源的文件夹可能残留衍生资源、未同步的索引数据，导致无法直接删除。需补充以下操作：

• 彻底清除所有关联资源及衍生版本
  DeleteResourcesByPrefix仅删除原始资源，不会处理缩放、裁剪等衍生图。需使用带参数的DeleteResources方法，确保清除所有相关资源：

  var deleteParams = new DelResParams
  {
      Prefix = folder.Path,
      DeleteDerivedResources = true,
      All = true // 包含已标记删除的资源
  };
  var deleteResult = instance.DeleteResources(deleteParams);
  

• 添加重试与延迟机制
  Cloudinary的目录元数据更新存在延迟，资源删除后需等待索引同步。可添加重试逻辑，每次重试间隔一段时间：

  int retryCount = 0;
  bool deleteSuccess = false;
  while (retryCount < 3 && !deleteSuccess)
  {
      try
      {
          var result = instance.DeleteFolder(folder.Path);
          Console.WriteLine($"Deleted Folder: {result.StatusCode}");
          deleteSuccess = true;
      }
      catch (Exception ex)
      {
          retryCount++;
          Console.WriteLine($"Attempt {retryCount} failed: {ex.Message}");
          System.Threading.Thread.Sleep(10000); // 间隔10秒重试
      }
  }
  

• 确认无残留资源与子文件夹
  删除前调用ListResourcesByPrefix检查是否还有遗漏资源，调用SubFolders确认子文件夹已全部删除，确保目录完全为空后再执行删除操作。

修改后的完整DeleteFolder方法示例：

public static void DeleteFolder(Cloudinary instance, Folder folder, bool recursive)
{
    // 删除所有匹配前缀的资源及衍生版本
    var deleteParams = new DelResParams
    {
        Prefix = folder.Path,
        DeleteDerivedResources = true,
        All = true
    };
    var deleteResult = instance.DeleteResources(deleteParams);
    Console.WriteLine($"Deleted {deleteResult.Deleted.Count} resources");

    if (recursive)
    {
        var foldersResult = instance.SubFolders(folder.Path);
        if (foldersResult.TotalCount > 0)
        {
            foreach (var subFolder in foldersResult.Folders)
            {
                DeleteFolder(instance, subFolder, recursive);
            }
        }
    }

    // 重试删除文件夹
    int retryCount = 0;
    bool deleteSuccess = false;
    while (retryCount < 3 && !deleteSuccess)
    {
        try
        {
            var result = instance.DeleteFolder(folder.Path);
            Console.WriteLine($"Deleted Folder: {result.StatusCode}");
            deleteSuccess = true;
        }
        catch (Exception ex)
        {
            retryCount++;
            Console.WriteLine($"Delete attempt {retryCount} failed: {ex.Message}");
            System.Threading.Thread.Sleep(10000);
        }
    }
}

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