调用GetAuthorizationContextAsync触发响应已启动错误及OnInitializedAsync重复执行问题

问题描述 #

调用Duende.IdentityServer.Services.DefaultIdentityServerInteractionService.GetAuthorizationContextAsync(String returnUrl)时，抛出错误：

System.InvalidOperationException: OnStarting cannot be set because the response has already started

该方法在登录表单Razor组件的OnInitializedAsync()中调用，调试发现OnInitializedAsync()会执行三次：

• 第一次为预渲染，执行正常
• 第二次执行正常，页面渲染完成
• 第三次执行时页面已渲染，触发错误并断开连接

相关代码 #

@page "/Account/login"

@inject IIdentityServerInteractionService interaction

@rendermode InteractiveServer

<EditForm FormName="login-form" Model="@model" OnValidSubmit="UserLogin">
    <InputText Placeholder="Enter your username"
                    @bind-Value=model.Username/>
    <InputText Placeholder="Enter your password"
                    @bind-Value=model.Password/>

    <button type="submit">Login</button>
</EditForm>


@code {

    [SupplyParameterFromQuery]
    private string? returnUrl { get; set; }

    [SupplyParameterFromForm]
    private LoginInputModel model { get; set; } = new();

    // 错误在该方法第三次执行时抛出
    protected override async Task OnInitializedAsync()
    {
        var vm = await BuildLoginViewModelAsync(returnUrl);
    }

    private async Task UserLogin() { }

    private async Task<LoginViewModel> BuildLoginViewModelAsync(string returnUrl)
    {
        // 错误触发点
        var context = await interaction.GetAuthorizationContextAsync(returnUrl);

        return new LoginViewModel();
    }
}

示例returnUrl #

"/connect/authorize/callback?
client_id=webapp&
redirect_uri=https%3A%2F%2Flocalhost%3A7188%2Fsignin-oidc&
response_type=code&
scope=openid%20profile%20core-api&
code_challenge=neweRQ7n0ozZYVRUAmkK5Sy9HA_W4zVQZtagNWc_Nx4&
code_challenge_method=S256&
response_mode=form_post&
nonce=638421522594225203.MWZkNTNiNDgtZjNlMS00MTdjLWEwZDItZWQ0ZTRmODkwN2ExM2QzMGIwODgtMjFkYS00ZDk2LTk2NGItOGU2MjE2YzBlNTk0&
state=CfDJ8HEuPZo8hC1NjU6vRJir-D8WZp_uajNVpQxcKBeeTsf0q4Yf8fQykOIXck_1FAo-FKgarNQfBsV9BNoBkICIuTuee89MzYKClkdoUDZcanQs6rRaR6E-EFO8DtPxc6MvZci1bejm2_xV2NSiM9-y9yMrenDSRc6ul3TUgNOjnX4BIwGPfAdSAfO9k0JNVYPwRcCwzCPNJDpLxyR3uQzjqh9_KD6FZ3uRX4hJOtLkJwSakZDdE94wkEh2evubTcvciVEDdhQFnWAp0vL_yEI0qGt8m42urSi6rVHDAemd0zAU8WhCrz-mTLDXvxw-RPiUC6MIutl9HMYrRhwxTuU0kGDBbzcdf4NgJrPEkifmlNAiK2XTSWMGILmoIracKacULA&
x-client-SKU=ID_NET8_0&
x-client-ver=7.1.2.0"

原因分析 #

1. InteractiveServer模式的组件生命周期特性：该模式下组件会经历预渲染、客户端连接建立后重新初始化两个阶段，但第三次执行通常是因为组件参数变更（比如[SupplyParameterFromForm]绑定的model字段在交互时触发重新绑定）或连接重连，此时HTTP响应已经发送到客户端，无法再修改响应头或添加OnStarting回调。
2. GetAuthorizationContextAsync的内部逻辑：该方法内部可能会尝试操作HTTP响应（比如处理授权上下文相关的Cookie或重定向逻辑），当响应已启动时，这类操作会触发OnStarting cannot be set错误。

解决方案 #

1. 限制初始化逻辑仅执行一次 #

添加布尔标记，避免重复执行授权上下文获取逻辑：

@code {
    private bool _hasInitialized = false;

    protected override async Task OnInitializedAsync()
    {
        if (_hasInitialized) return;
        
        var vm = await BuildLoginViewModelAsync(returnUrl);
        _hasInitialized = true;
    }
}

2. 仅在预渲染阶段调用该方法 #

利用IsPreRendering属性，只在服务器预渲染时获取授权上下文，此时响应尚未发送：

protected override async Task OnInitializedAsync()
{
    if (IsPreRendering)
    {
        var vm = await BuildLoginViewModelAsync(returnUrl);
    }
}

3. 调整参数绑定方式 #

移除model字段的[SupplyParameterFromForm]属性，表单数据在UserLogin方法中直接处理，避免参数变更触发组件重复初始化：

@code {
    // 移除[SupplyParameterFromForm]
    private LoginInputModel model { get; set; } = new();

    private async Task UserLogin()
    {
        // 在这里处理表单提交逻辑，比如验证model
    }
}

4. 移到服务器端处理 #

将获取授权上下文的逻辑移到Razor Page的OnGet方法中，通过参数传递给Blazor组件，完全避开组件初始化阶段的响应冲突：

// 在Login.cshtml.cs中
public async Task OnGetAsync(string returnUrl)
{
    var context = await _interaction.GetAuthorizationContextAsync(returnUrl);
    ViewData["LoginViewModel"] = new LoginViewModel { /* 填充数据 */ };
}

// 在Blazor组件中接收参数
[Parameter]
public LoginViewModel? ViewModel { get; set; }

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