.NET MAUI更换头像报错：文件被其他进程占用

问题概述 #

在SettingsPage实现用户更换头像功能，头像本地存储为profile.jpg。选择新图片并覆盖复制到该文件时，出现错误：

'The process cannot access the file 'C:\Users\Mess\AppData\Local\2b81b8b3-3ce3-42f9-ad01-256194f0daaf\images\profile.jpg' because it is being used by another process.'

推测是Profile页的Image控件持续占用profile.jpg文件句柄，导致无法覆盖写入。

相关代码如下：

SettingsPage.xaml.cs #

public async void OnSaveButtonClicked(object sender, EventArgs e)
{
    //Saving user data in DB
    UsersData usersData = new UsersData();
      await usersData.UpdateUserData(currentUser.user_id, fNameTxt.Text,
                       lNameTxt.Text,
                       emailTxt.Text,
                       phoneTxt.Text,
                       bDayPicker.Date,
                       double.Parse(heightTxt.Text),
                       double.Parse(objectiveTxt.Text));
    //Updating profile Pic
    if (picChanged)
    {
        File.Copy(profile_picture_file.FullPath, localFolder + "/profile.jpg", true);
        await uploadProfilePictureToFTP(profile_picture_file, currentUser.secret_id);
    }
}

Profile.xaml.cs #

protected override async void OnAppearing()
{
    base.OnAppearing();
    
    //Test case
     UsersData usersData = new UsersData();
        currentUser = await usersData.findUserByMailAsync("faat"); //just to test with test user
  
    await pictureController.assingUser(currentUser);
    //picture models scrab from database (picName,picDate...)
   if (pictureModels==null) pictureModels = await pictureController.ScrabPicturesFromDB(currentUser);
    //Getting profile pic
    if (pageCounter == 0)
    {
        PicturesController.setLocalFolder(currentUser);
        local_image_folder = PicturesController.localFolder;
        if (!Directory.Exists(local_image_folder))
            Directory.CreateDirectory(local_image_folder);
        if (File.Exists(local_image_folder + "/profile.jpg"))
        {
            profilePic.Source = ImageSource.FromFile(local_image_folder + "/profile.jpg");
            profilePicExists = true;
        }
        
    }
    //check download missing pics
    Task.Run(async () => {

        await checkPicturesAsync();

        Dispatcher.Dispatch(() =>
        {
            GalleryControl.BackgroundColor = Colors.Green;
            WeightButton.BackgroundColor = Colors.Green;
            TimeLapseButton.BackgroundColor = Colors.Green;
            if (!profilePicExists)
            {
                profilePic.Source = ImageSource.FromFile(local_image_folder + "/profile.jpg");
            }
              });
        });
}

曾尝试通过临时文件profile2.jpg中转，清空Image控件Source后再覆盖，但仍出现相同错误。

可行解决方法 #

1. 改用内存流加载头像，避免文件锁定 #

ImageSource.FromFile会保持文件句柄打开，导致文件被锁定。改为将文件内容读入内存流，控件使用内存中的数据，释放原文件的占用：

修改Profile页中加载头像的代码：

if (File.Exists(local_image_folder + "/profile.jpg"))
{
    // 将文件读入字节数组，再转为内存流加载
    byte[] imageBytes = File.ReadAllBytes(local_image_folder + "/profile.jpg");
    profilePic.Source = ImageSource.FromStream(() => new MemoryStream(imageBytes));
    profilePicExists = true;
}

同理，在Dispatcher.Dispatch中的加载逻辑也做同样修改：

if (!profilePicExists)
{
    byte[] imageBytes = File.ReadAllBytes(local_image_folder + "/profile.jpg");
    profilePic.Source = ImageSource.FromStream(() => new MemoryStream(imageBytes));
}

2. 跨页面通知释放文件引用 #

在SettingsPage执行文件覆盖前，通知Profile页清空Image控件的Source，确保文件被释放：

在SettingsPage中添加通知逻辑

if (picChanged)
{
    // 通知Profile页释放头像文件
    MessagingCenter.Send(this, "ReleaseProfilePic");
    // 短暂等待确保控件释放完成
    await Task.Delay(100);
    
    File.Copy(profile_picture_file.FullPath, localFolder + "/profile.jpg", true);
    await uploadProfilePictureToFTP(profile_picture_file, currentUser.secret_id);
    
    // 通知Profile页更新头像
    MessagingCenter.Send(this, "UpdateProfilePic");
}

在Profile页订阅消息

在Profile页的构造函数中添加订阅：

public ProfilePage()
{
    InitializeComponent();
    
    // 订阅释放文件的通知
    MessagingCenter.Subscribe<SettingsPage>(this, "ReleaseProfilePic", (sender) =>
    {
        profilePic.Source = null;
        profilePicExists = false;
    });

    // 订阅更新头像的通知
    MessagingCenter.Subscribe<SettingsPage>(this, "UpdateProfilePic", (sender) =>
    {
        if (File.Exists(local_image_folder + "/profile.jpg"))
        {
            byte[] imageBytes = File.ReadAllBytes(local_image_folder + "/profile.jpg");
            profilePic.Source = ImageSource.FromStream(() => new MemoryStream(imageBytes));
            profilePicExists = true;
        }
    });
}

3. 优化临时文件替换策略 #

通过临时文件中转，确保替换时原文件未被占用：

修改SettingsPage的头像更新逻辑

if (picChanged)
{
    string tempFilePath = localFolder + "/profile_temp.jpg";
    // 先将新图片复制到临时文件
    File.Copy(profile_picture_file.FullPath, tempFilePath, true);
    await uploadProfilePictureToFTP(profile_picture_file, currentUser.secret_id);
    
    // 通知Profile页先显示临时头像
    MessagingCenter.Send(this, "LoadTempProfilePic", tempFilePath);
    await Task.Delay(100);
    
    // 删除原文件并重命名临时文件
    if (File.Exists(localFolder + "/profile.jpg"))
    {
        File.Delete(localFolder + "/profile.jpg");
    }
    File.Move(tempFilePath, localFolder + "/profile.jpg");
    
    // 通知Profile页切换回正式头像
    MessagingCenter.Send(this, "UpdateProfilePic");
}

在Profile页添加临时头像加载逻辑

// 在构造函数中添加临时头像加载的订阅
MessagingCenter.Subscribe<SettingsPage, string>(this, "LoadTempProfilePic", (sender, tempPath) =>
{
    if (File.Exists(tempPath))
    {
        byte[] imageBytes = File.ReadAllBytes(tempPath);
        profilePic.Source = ImageSource.FromStream(() => new MemoryStream(imageBytes));
    }
});

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