Blazor Server部署Azure App Service时HttpContext为空致Cookie同意组件报错

问题核心 #

本地开发正常，但部署到Azure App Service后，IHttpContextAccessor.HttpContext为空，导致ITrackingConsentFeature获取失败，触发NullReferenceException。这是因为Blazor Server的组件生命周期中，OnInitialized阶段可能早于HttpContext绑定完成，且Azure环境的请求管道与本地存在差异。

解决方案 #

1. 切换到OnAfterRenderAsync生命周期方法 #

Blazor Server初始请求为HTTP请求，OnAfterRenderAsync（首次渲染时）能确保HttpContext已绑定。修改组件代码如下：

ITrackingConsentFeature consentFeature;
bool showBanner;
string cookieString;
bool _hasInitialized = false;

protected override async Task OnAfterRenderAsync(bool firstRender)
{
    if (firstRender && !_hasInitialized)
    {
        _hasInitialized = true;
        
        if (hca.HttpContext != null)
        {
            consentFeature = hca.HttpContext.Features.Get<ITrackingConsentFeature>();
            showBanner = consentFeature?.CanTrack != true;
            cookieString = consentFeature?.CreateConsentCookie();
        }
        else
        {
            // 兜底处理：HttpContext为空时默认隐藏提示
            showBanner = false;
        }
        
        // 通知组件更新UI
        StateHasChanged();
    }
    
    await base.OnAfterRenderAsync(firstRender);
}

2. 确保中间件顺序正确 #

在Program.cs中，UseCookiePolicy必须放在Blazor相关中间件之前，保证Cookie策略在Blazor初始化前生效：

var builder = WebApplication.CreateBuilder(args);

// 注册服务
builder.Services.AddHttpContextAccessor();
builder.Services.AddServerSideBlazor();
builder.Services.AddCookiePolicy(options =>
{
    options.CheckConsentNeeded = context => true;
    options.MinimumSameSitePolicy = SameSiteMode.None;
});

var app = builder.Build();

// 中间件顺序：CookiePolicy优先于Blazor
app.UseCookiePolicy();
app.UseStaticFiles();
app.UseRouting();

app.MapBlazorHub();
app.MapFallbackToPage("/_Host");

app.Run();

3. 检查Azure App Service会话亲和性设置 #

Blazor Server依赖会话亲和性（ARR Affinity）来维持SignalR连接，若该设置关闭会导致HttpContext异常：

• 进入Azure门户的目标App Service
• 导航至「设置」→「配置」→「常规设置」
• 确认「ARR Affinity」处于开启状态

4. 增加全局空值保护 #

在使用ITrackingConsentFeature的所有逻辑中，始终保留空值判断，避免出现未处理的空引用：

// 示例：同意按钮点击事件
public void AcceptConsent()
{
    if (consentFeature != null)
    {
        consentFeature.GrantConsent();
        showBanner = false;
        StateHasChanged();
    }
}

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