Blazor IConfiguration 读取配置信息教程

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 文件。

标签： js 前端 json 浏览器 app 后端 环境变量 .net