17370845950

Blazor应用按环境配置分Server与WASM两类：Server沿用ASP.NET Core机制，自动加载appsettings.{Environment}.json；WASM需手动AddJsonFile并注入环境名，敏感配置须后端提供。

Blazor 应用在不同环境（如开发、测试、生产）中使用不同配置，核心思路和 ASP.NET Core 一致：依靠 环境变量（ASPNETCORE_ENVIRONMENT） + 分环境的配置文件（appsettings.{Environment}.json），并结合 Blazor 的启动逻辑加载对应配置。

服务端渲染（Blazor Server）直接沿用 ASP.NET Core 配置机制

Blazor Server 是标准的 ASP.NET Core 应用，配置方式完全相同：

• 项目根目录下保留 appsettings.json（通用配置）和 appsettings.Development.json、appsettings.Production.json 等环境专属文件
• 确保这些文件的 “复制到输出目录”属性设为“如果较新则复制”
• 在 Program.cs 中调用 builder.Configuration 加载配置，无需额外操作 —— 框架会自动根据 ASPNETCORE_ENVIRONMENT 值合并对应文件
• 例如，在开发环境下运行时，appsettings.Development.json 会自动覆盖 appsettings.json 中的同名键

WebAssembly（Blazor WASM）需手动加载环境配置文件

Blazor WASM 运行在浏览器中，没有服务器端环境变量，也不能直接读取本地文件系统。它通过 HTTP 请求加载 JSON 配置，因此要按环境区分，关键在于：

• 构建时生成对应环境的 appsettings.{Environment}.json 文件（如 appsettings.Staging.json）并部署到服务器同一目录下
• 在 Program.cs 中显式调用 configuration.AddJsonFile 并传入带环境名的路径
• 环境名通常由构建参数或部署脚本控制，比如用 MSBuild 属性 $(Configuration) 或自定义变量

示例（WASM 的 Program.cs）：

统一管理环境标识：避免硬编码环境名

硬写 "Development" 或 "Production" 容易出错。推荐做法：

• Blazor Server：依赖 IWebHostEnvironment.Environment（已内置）
• Blazor WASM：通过 WebAssemblyHostBuilder.HostEnvironment.Environment 获取（默认由 index.html 中的 window["blazor-environment"] 或构建时注入的 __env 决定）
• 更可靠的方式是在发布前，用构建脚本（如 GitHub Actions、Azure DevOps 或 MSBuild Target）向 index.html 注入环境标识，或通过 JS interop 读取 location.hostname 映射环境（例如 dev.example.com → Development）

敏感配置不放 appsettings.json，用环境变量或密钥管理器

数据库连接字符串、API 密钥等不应提交到代码库：

• Blazor Server：用 dotnet user-secrets（开发）或操作系统级环境变量（生产）替代 JSON 中的敏感项
• Blazor WASM：切勿在客户端存储敏感配置 —— 所有密钥必须由后端 API 提供，前端只持 Token 或临时凭证
• 若 WASM 需要调用不同环境的后端地址，可将 API 基地址作为公开配置（如 ApiBaseUri）放在 appsettings.{env}.json 中，这是安全且常见的做法

基本上就这些。关键是分清 Blazor Server 和 WASM 的运行模型差异：Server 走标准 .NET 配置管道，WASM 则靠前端资源加载 + 构建时/运行时注入环境上下文。