Blazor应用读取配置需区分环境:Server端支持完整ASP.net Core配置模型,可注入IConfiguration读取appsettings.json等;wasm端仅支持wwwroot下静态json文件,不支持动态配置源,敏感信息须由后端提供。

Blazor 应用中读取配置信息,核心是通过 IConfiguration 接口获取,但要注意:服务端渲染(Blazor Server)和客户端渲染(Blazor WebAssembly)的配置加载机制完全不同,不能混用。
Blazor Server 中使用 IConfiguration
它运行在 .NET 后端,完全支持标准 ASP.NET Core 配置模型,可直接注入 IConfiguration 读取 appsettings.json、环境变量、命令行参数等。
- 在
Program.cs或Startup.cs中已自动注册,无需额外操作 - 在组件(.razor)中按需注入:
@inject IConfiguration Configuration - 读取示例:
@Configuration["Logging:LogLevel:default"]或@Configuration.GetSection("ConnectionStrings")["Default"] - 推荐封装为强类型配置类,用
Configuration.GetSection("MyOptions").Get<myoptions>()</myoptions>提升可维护性
Blazor WebAssembly 中 IConfiguration 的限制
它运行在浏览器沙箱中,无法访问服务器文件系统或环境变量。默认只加载 wwwroot/appsettings.json(及对应环境变体如 appsettings.Development.json),且仅限静态 JSON 文件。
- 确保
appsettings.json已放在wwwroot目录下,并设置为“内容”+“复制到输出目录” - 启动时框架自动加载,
IConfiguration可正常注入和使用,方式与 Server 端一致 - 不支持从数据库、azure Key Vault、自定义 Provider 动态加载配置——必须提前打包进前端资源
- 敏感信息(如 API 密钥)绝不能写在
appsettings.json中,应由后端 API 统一鉴权返回
跨平台统一读取技巧(Server + WASM 兼容)
若项目同时支持两种托管模型,可通过抽象配置逻辑避免重复判断。
- 定义共享配置接口(如
IAppSettings)和实现类,按环境注入不同实现 - 在
Program.cs中区分注册:builder.Services.AddSingleton<iappsettings serverappsettings>()</iappsettings>或WasmAppSettings - 业务组件只依赖接口,不关心底层如何读取,提升可测试性和可移植性
基本上就这些。关键是分清运行环境,别在 WASM 里尝试读取 appsettings.Production.json 却忘了把它发布到 wwwroot 下——配置不会自动“找得到”,得你亲手放对位置。