如何在ContentView中正确清理Maui Community Toolkit的MediaElement？

问题核心是你混淆了ContentView和Page的生命周期：ContentView的Unloaded事件触发时机不稳定，此时MediaElement的Handler可能已被框架回收或处于异常状态，直接调用DisconnectHandler()会引发崩溃。以下是两种可靠的解决方案：

方案一：监听宿主页面的Unloaded事件 #

通过重写ContentView的OnParentChanged方法，自动绑定宿主Page的Unloaded事件，在页面离开时执行稳定的清理操作：

private Page? _hostPage;

protected override void OnParentChanged()
{
    base.OnParentChanged();

    // 取消之前页面的事件订阅
    if (_hostPage != null)
    {
        _hostPage.Unloaded -= HostPage_Unloaded;
    }

    // 向上查找获取宿主Page（兼容ContentView嵌套场景）
    _hostPage = FindParentPage(Parent);
    if (_hostPage != null)
    {
        _hostPage.Unloaded += HostPage_Unloaded;
    }
}

private Page? FindParentPage(Element? element)
{
    while (element != null)
    {
        if (element is Page page)
            return page;
        element = element.Parent;
    }
    return null;
}

private void HostPage_Unloaded(object? sender, EventArgs e)
{
    // 先停止播放，释放媒体资源
    mediaElement.Stop();

    // 安全清理Handler，用try-catch避免意外崩溃
    if (mediaElement.Handler != null)
    {
        try
        {
            mediaElement.Handler.DisconnectHandler();
        }
        catch (Exception ex)
        {
            // 可添加日志记录，便于排查问题
            Console.WriteLine($"MediaElement清理失败: {ex.Message}");
        }
    }

    // 取消订阅防止内存泄漏
    if (_hostPage != null)
    {
        _hostPage.Unloaded -= HostPage_Unloaded;
        _hostPage = null;
    }
}

方案二：让宿主页面主动调用清理方法 #

在ContentView中暴露公共清理方法，由使用它的Page在自身Unloaded事件中主动调用：

1. 自定义ContentView中定义清理方法 #

public void CleanupMedia()
{
    mediaElement.Stop();
    if (mediaElement.Handler != null)
    {
        try
        {
            mediaElement.Handler.DisconnectHandler();
        }
        catch (Exception ex)
        {
            Console.WriteLine($"MediaElement清理异常: {ex.Message}");
        }
    }
}

2. 宿主Page的Unloaded事件中调用 #

private void CurrentPage_Unloaded(object? sender, EventArgs e)
{
    myCustomContentView.CleanupMedia();
}

关键注意事项 #

• 禁止直接在ContentView的Unloaded事件中执行MediaElement的Handler清理，此时控件内部状态已不可控。
• 清理前必须调用Stop()，避免媒体资源未释放导致内存泄漏。
• 用try-catch包裹清理逻辑，防止个别场景下的异常扩散影响应用稳定性。

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