.NET Blazor MAUI Hybrid添加appsettings.json的正确方式咨询

问题场景 #

使用Visual Studio 2022 17.9.2、.NET 8开发Blazor MAUI Hybrid应用，将appsettings.json放在wwwroot目录下后，尝试两种加载方式：

• 尝试1：通过文件路径直接加载，Windows平台正常运行，但Android模拟器构建时报错找不到文件
• 尝试2：将文件设置为嵌入资源加载，功能可行但不确定是否为标准实现方案

尝试1 Android报错原因 #

Windows平台下，wwwroot目录的文件会保留原路径结构，可直接通过相对路径访问；但Android平台中，MAUI不会自动将wwwroot下的文件复制到应用的可访问物理路径，导致AddJsonFile无法找到指定文件，触发错误：

The configuration file 'wwwroot/appsettings.json' was not found and is not optional. The expected physical path was '/data/user/0/com.companyname.myappname/files/wwwroot/

尝试2的合理性与优化 #

将appsettings.json设置为嵌入资源是MAUI跨平台加载配置的常见可行方案，可以通过优化避免硬编码资源名称，提升代码可维护性：

优化后的嵌入资源加载代码 #

public static class MauiProgram
{
    public static MauiApp CreateMauiApp()
    {
        var builder = MauiApp.CreateBuilder();
        builder.UseMauiApp<App>();

        // 加载嵌入的appsettings.json
        var assembly = typeof(MauiProgram).Assembly;
        var resourceName = $"{assembly.GetName().Name}.wwwroot.appsettings.json";
        
        using var stream = assembly.GetManifestResourceStream(resourceName);
        if (stream != null)
        {
            var config = new ConfigurationBuilder()
                .AddJsonStream(stream)
                .Build();
            builder.Configuration.AddConfiguration(config);
        }

        builder.Services.AddMauiBlazorWebView();
        builder.Services.AddRadzenComponents();
        ConfigureServices(builder.Services);

#if DEBUG
        builder.Services.AddBlazorWebViewDeveloperTools();
        builder.Logging.AddDebug();
#endif

        return builder.Build();
    }

    static void ConfigureServices(IServiceCollection services)
    {
        // 注册自定义服务
        // services.AddScoped<XyzService>();
    }
}

通过typeof(MauiProgram).Assembly动态获取当前程序集，再拼接资源名称，避免硬编码项目名称，适配项目重命名场景。

另一种标准方案：MAUI资源复制机制 #

除嵌入资源外，还可通过设置文件属性为MauiAsset，结合文件复制逻辑实现加载，支持配置热重载：

步骤1：配置文件属性 #

右键wwwroot/appsettings.json → 属性：

• 生成操作：MauiAsset
• 复制到输出目录：如果较新则复制

步骤2：加载配置的代码 #

public static class MauiProgram
{
    public static MauiApp CreateMauiApp()
    {
        var builder = MauiApp.CreateBuilder();
        builder.UseMauiApp<App>();

        // 获取appsettings.json的可访问路径
        var filePath = Path.Combine(FileSystem.AppDataDirectory, "wwwroot", "appsettings.json");
        
        // 首次运行时从MAUI资源包复制文件到可访问目录
        if (!File.Exists(filePath))
        {
            using var assetStream = FileSystem.OpenAppPackageFileAsync("wwwroot/appsettings.json").Result;
            using var fileStream = File.Create(filePath);
            assetStream.CopyTo(fileStream);
        }

        // 加载配置，支持热重载
        var config = new ConfigurationBuilder()
            .AddJsonFile(filePath, optional: false, reloadOnChange: true)
            .Build();
        builder.Configuration.AddConfiguration(config);

        builder.Services.AddMauiBlazorWebView();
        builder.Services.AddRadzenComponents();
        ConfigureServices(builder.Services);

#if DEBUG
        builder.Services.AddBlazorWebViewDeveloperTools();
        builder.Logging.AddDebug();
#endif

        return builder.Build();
    }

    static void ConfigureServices(IServiceCollection services)
    {
        // 注册自定义服务
        // services.AddScoped<XyzService>();
    }
}

该方案的优势是支持reloadOnChange，运行时修改配置文件即可生效，适合需要动态调整配置的场景；嵌入资源方案的配置文件会打包进程序集，无法在运行时修改。

方案选择建议 #

• 配置无需运行时修改：优先选嵌入资源方案，实现简单，无文件复制逻辑
• 需要运行时修改配置：选MauiAsset+文件复制方案，支持配置热重载

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