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下——配置不会自动“找得到”,得你亲手放对位置。
