.NET MAUI注入MainPage时出现StaticResource找不到错误

问题根源 #

当通过DI把MainPage注入到App构造函数时，MainPage会在App的全局资源字典加载完成前被实例化。此时MainPage里引用的SecondaryBackroundColor这类静态资源还没被注册到应用资源系统中，自然会抛出「StaticResource not found for key」错误。而不注入时，MainPage通常是在App初始化完成后才创建，资源已经加载完毕，所以能正常运行。

具体解决方案 #

1. 延迟MainPage的实例化时机

不在App构造函数中直接注入MainPage，改为在App的OnStart方法中从服务容器获取并设置：

public partial class App : Application
{
    private readonly IServiceProvider _services;

    // 仅注入服务容器，不直接注入MainPage
    public App(IServiceProvider services)
    {
        InitializeComponent();
        _services = services;
    }

    protected override void OnStart()
    {
        // 此时App资源已加载完成，再实例化MainPage
        MainPage = _services.GetRequiredService<MainPage>();
    }
}

2. 确保资源字典先于MainPage加载

如果一定要在App构造函数中处理，先手动完成资源加载，再获取MainPage：

public App(IServiceProvider services)
{
    // 先执行InitializeComponent加载App.xaml中的资源字典
    InitializeComponent();
    // 若有外部主题资源字典，可在此手动添加
    // Resources.MergedDictionaries.Add(new ThemeResources());
    
    // 资源加载完成后，再实例化MainPage
    MainPage = services.GetRequiredService<MainPage>();
}

3. 改用DynamicResource替代StaticResource

把MainPage中使用的StaticResource替换为DynamicResource，即使初始化时找不到资源，后续资源加载完成后会自动更新UI：

<!-- MainPage.xaml 中修改资源引用方式 -->
<Grid BackgroundColor="{DynamicResource SecondaryBackroundColor}">
    <!-- 页面内容 -->
</Grid>

这个方法无需调整DI或初始化顺序，是最简便的解决方案。

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