Uno WASM平台下StorageFile.RenameAsync方法卡住无法重命名文件问题

问题原因排查 #

1. 首先你提供的示例代码存在强制类型转换错误：imageList.SelectedItems as StorageFile 是非法转换，SelectedItems 是选中项集合类型，直接转单个StorageFile会得到null，UWP环境能跑通大概率是你实际代码写的是转IEnumerable<object>再遍历，只是示例代码笔误，这个问题优先修正。
2. Uno WASM平台的StorageFile.RenameAsync卡住的核心原因不是IReadOnlyList的兼容性，是两个平台特有问题：
   • WASM受浏览器沙箱文件系统权限限制，通过FolderPicker拿到的文件句柄在重命名时，如果你没有指定重名处理规则、也没有捕获异常，只要有一个重命名冲突，异步方法就会进入未捕获的故障状态导致卡住
   • 你在foreach循环里直接写await异步调用，WASM的单线程调度模型下，如果前一个异步操作没有正确返回，后续迭代会被直接阻塞
3. 另外Uno 4.x及更早版本对WASM端的RenameAsync实现存在已知bug，没有正确处理文件重命名后的句柄更新，会导致异步任务不返回。

可行解决办法 #

方案1：修正代码逻辑+适配WASM特性（推荐）

先修正类型转换逻辑，增加异常捕获和重名处理规则，修改后代码如下：

int imageNumber = 0;
// 先把选中项转成列表再遍历，避免遍历时绑定集合变动引发异常
var selectedFiles = imageList.SelectedItems.OfType<StorageFile>().ToList();
foreach(var sf in selectedFiles)
{
    imageNumber++;
    string newname = $"{imageNumber}.jpg";
    try
    {
        // 显式指定重名处理规则，避免无响应
        await sf.RenameAsync(newname, NameCollisionOption.ReplaceExisting);
    }
    catch(Exception ex)
    {
        // 捕获单文件操作异常，避免阻塞整个批量流程
        Console.WriteLine($"文件 {sf.Name} 重命名失败:{ex.Message}");
    }
}

修改完成后先测试，如果还是卡住，将Uno框架升级到5.0及以上版本，官方已经修复了WASM端RenameAsync异步任务不返回的问题。

方案2：绕开RenameAsync实现（适配旧版本Uno）

如果暂时不能升级框架，可以用读写新建+删除原文件的方式绕过原生API的问题，代码示例：

int imageNumber = 0;
var selectedFiles = imageList.SelectedItems.OfType<StorageFile>().ToList();
foreach(var sf in selectedFiles)
{
    imageNumber++;
    string newname = $"{imageNumber}.jpg";
    try
    {
        // 读取原文件内容
        using var readStream = await sf.OpenStreamForReadAsync();
        // 创建新命名的文件
        var newFile = await SourceFolder.CreateFileAsync(newname, CreationCollisionOption.ReplaceExisting);
        // 写入内容
        using var writeStream = await newFile.OpenStreamForWriteAsync();
        await readStream.CopyToAsync(writeStream);
        // 删除原文件
        await sf.DeleteAsync();
        // 更新绑定集合
        SourceFiles.Remove(sf);
        SourceFiles.Add(newFile);
    }
    catch(Exception ex)
    {
        Console.WriteLine($"文件 {sf.Name} 重命名失败:{ex.Message}");
    }
}

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