如何为独立Blazor WASM应用设置自定义环境变量？

1. 自定义配置提供器读取请求头 #

要实现需求，你需要自定义一个配置提供器，用来从请求头中提取自定义环境变量。

创建HeaderConfigurationProvider类：

using Microsoft.Extensions.Configuration;
using System.Collections.Generic;
using System.Linq;

public class HeaderConfigurationProvider : ConfigurationProvider
{
    private readonly IHttpContextAccessor _httpContextAccessor;
    private const string HeaderName = "Blazor-Environment-Variable";
    private const string Separator = "=";

    public HeaderConfigurationProvider(IHttpContextAccessor httpContextAccessor)
    {
        _httpContextAccessor = httpContextAccessor;
    }

    public override void Load()
    {
        var context = _httpContextAccessor.HttpContext;
        if (context == null || !context.Request.Headers.ContainsKey(HeaderName))
        {
            Data = new Dictionary<string, string>();
            return;
        }

        var headerValues = context.Request.Headers[HeaderName];
        Data = headerValues
            .Select(v => v.Split(new[] { Separator }, 2))
            .Where(parts => parts.Length == 2)
            .ToDictionary(parts => parts[0].Trim(), parts => parts[1].Trim());
    }
}

再创建对应的配置源：

using Microsoft.Extensions.Configuration;

public class HeaderConfigurationSource : IConfigurationSource
{
    private readonly IHttpContextAccessor _httpContextAccessor;

    public HeaderConfigurationSource(IHttpContextAccessor httpContextAccessor)
    {
        _httpContextAccessor = httpContextAccessor;
    }

    public IConfigurationProvider Build(IConfigurationBuilder builder)
    {
        return new HeaderConfigurationProvider(_httpContextAccessor);
    }
}

2. 注册自定义配置提供器 #

在Program.cs中，将自定义配置源添加到配置构建器（建议放在环境变量配置之后，让请求头变量可覆盖默认环境变量）：

var builder = WebApplication.CreateBuilder(args);

// 注册HttpContextAccessor服务
builder.Services.AddHttpContextAccessor();

// 添加自定义请求头配置源
builder.Configuration.Add(new HeaderConfigurationSource(builder.Services.BuildServiceProvider().GetRequiredService<IHttpContextAccessor>()));

// 其他Blazor相关服务注册
builder.Services.AddRazorPages();
builder.Services.AddServerSideBlazor();

var app = builder.Build();

// 中间件配置...
app.Run();

3. 通过IConfiguration或IOptions访问变量 #

直接用IConfiguration读取 #

@inject IConfiguration Configuration

<p>自定义变量值：@Configuration["MyCustomVar"]</p>

绑定到强类型选项类 #

先创建选项类：

public class CustomSettings
{
    public string MyCustomVar { get; set; }
    public int AnotherVar { get; set; }
}

在Program.cs中注册选项：

builder.Services.Configure<CustomSettings>(builder.Configuration);

组件中注入使用：

@inject IOptions<CustomSettings> CustomSettings

<p>MyCustomVar的值：@CustomSettings.Value.MyCustomVar</p>
<p>AnotherVar的值：@CustomSettings.Value.AnotherVar</p>

4. 请求头传递格式 #

发送请求时，添加Blazor-Environment-Variable请求头，格式为变量名=变量值，多个变量可添加多个请求头条目：

Blazor-Environment-Variable: MyCustomVar=HelloFromHeader
Blazor-Environment-Variable: AnotherVar=123

注意事项 #

• 该方案仅适用于Server-Side Blazor，WebAssembly Blazor运行在客户端，无法直接读取服务器请求头，需通过API接口传递变量。
• 注意请求头大小限制，避免传递过大的变量值。
• 生产环境建议对请求头来源做验证，防止恶意注入。

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