Xamarin.Forms：共享库中使用StaticResource遇未处理异常求助

我之前也踩过类似的坑，这种没有详细信息的UnhandledException大概率是资源查找失败或者加载顺序问题导致的，咱们一步步来排查解决：

1. 先确认共享库中App.xaml的样式定义是否规范 #

首先要保证你的样式是正确定义在ResourceDictionary内部，且TargetType和Key都没问题，比如：

<Application.Resources>
    <ResourceDictionary>
        <Style x:Key="TheLabelsStyle" TargetType="Label">
            <Setter Property="FontSize" Value="30"/>
            <Setter Property="Margin" Value="20,0,5,0"/>
            <Setter Property="WidthRequest" Value="30"/>
            <!-- 这里可以不用写VerticalOptions，因为你在引用时会手动覆盖 -->
        </Style>
    </ResourceDictionary>
</Application.Resources>

如果你的App.xaml里有多个资源字典，要检查合并语法是否正确，有没有遗漏闭合标签这类低级错误。

2. 确保主项目正确加载共享库的资源 #

主项目默认不会自动加载共享库的App.xaml资源，你需要在主项目的App.xaml中手动合并共享库的资源字典：

<Application.Resources>
    <ResourceDictionary>
        <ResourceDictionary.MergedDictionaries>
            <!-- 替换成你的共享库命名空间 -->
            <ResourceDictionary Source="clr-namespace:YourSharedLibraryName;component/App.xaml"/>
        </ResourceDictionary.MergedDictionaries>
        <!-- 主项目自身的资源可以放在这里 -->
    </ResourceDictionary>
</Application.Resources>

注意这里的命名空间和路径必须准确，component/App.xaml指向的是共享库根目录的App.xaml文件，如果你的样式在其他ResourceDictionary文件里，要对应修改路径。

3. 检查资源引用的细节 #

• 确认StaticResource的KeyTheLabelsStyle和共享库中定义的完全一致，XAML的资源Key是大小写敏感的，别因为大小写写错导致找不到资源。
• 如果是在共享库内部的页面引用样式，要注意共享库的App类可能不会被主项目自动初始化，这时候可以考虑把样式放到单独的ResourceDictionary文件中，而不是依赖共享库的App.xaml。

4. 捕获详细的异常信息（关键步骤） #

无详细信息的异常很难定位，你可以在主项目的App.xaml.cs中添加全局异常捕获，拿到具体的错误日志：

protected override void OnStart()
{
    AppDomain.CurrentDomain.UnhandledException += CurrentDomain_UnhandledException;
    TaskScheduler.UnobservedTaskException += TaskScheduler_UnobservedTaskException;
}

private void CurrentDomain_UnhandledException(object sender, UnhandledExceptionEventArgs e)
{
    var ex = e.ExceptionObject as Exception;
    // 输出到控制台或者日志文件，方便排查
    Console.WriteLine($"未处理异常: {ex?.Message}\n堆栈信息: {ex?.StackTrace}");
}

private void TaskScheduler_UnobservedTaskException(object sender, UnobservedTaskExceptionEventArgs e)
{
    Console.WriteLine($"未观察到的任务异常: {e.Exception.Message}\n堆栈信息: {e.Exception.StackTrace}");
    e.SetObserved();
}

通过这个方法，你能看到具体是找不到资源，还是样式中的某个Setter设置有误。

5. 备选方案：使用独立的ResourceDictionary文件 #

如果共享库的App.xaml加载有问题，推荐把样式放到单独的Styles.xaml文件中，这样更灵活：

<!-- 共享库中的Styles.xaml -->
<ResourceDictionary xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
                    xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
                    x:Class="YourSharedLibrary.Styles">
    <Style x:Key="TheLabelsStyle" TargetType="Label">
        <Setter Property="FontSize" Value="30"/>
        <Setter Property="Margin" Value="20,0,5,0"/>
        <Setter Property="WidthRequest" Value="30"/>
    </Style>
</ResourceDictionary>

然后在需要使用的页面中合并这个资源字典：

<ContentPage.Resources>
    <ResourceDictionary>
        <ResourceDictionary.MergedDictionaries>
            <local:Styles/>
            <!-- 或者用路径引用：<ResourceDictionary Source="Styles.xaml"/> -->
        </ResourceDictionary.MergedDictionaries>
    </ResourceDictionary>
</ContentPage.Resources>

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