Blazor中如何从ApiController重定向跳转至Razor页面

可以实现用户端跳转，但不能直接在ApiController中调用NavigationManager完成操作，NavigationManager是Blazor组件运行上下文中的服务，和独立运行的ApiController请求管道不连通，强行注入调用也不会对当前发起POST请求的用户浏览器生效。

你现在的架构（用ApiController接收POST回调）是Blazor处理外部POST回传的标准做法，跳转逻辑直接在控制器层完成即可，不需要借助Blazor组件内的服务：

• 外部站点处理完成后向你的回调接口发POST请求时，这个请求本身就是用户浏览器端发起的，当前HTTP请求的响应会直接被用户浏览器接收处理
• 你只需要在控制器处理完POST数据后，直接返回HTTP重定向响应，浏览器就会自动跳转到你指定的Blazor页面

实现步骤 #

1. 控制器接收POST payload后，先完成签名校验、数据合法性校验，不要把敏感的回调数据直接拼在重定向URL上传递：可以把处理后的数据存入短时缓存（内存缓存/分布式缓存都可以），生成一个随机的临时Key作为查询参数
2. 直接返回重定向结果，指向你Blazor应用内专门处理回调结果的Razor页面
3. 在对应的Razor页面中，从查询参数里取出临时Key，从缓存中拉取之前存的回调数据完成后续业务逻辑，这个阶段你可以在组件内正常使用NavigationManager做二次跳转

参考代码 #

控制器回调接口示例：

[ApiController]
[Route("api/external")]
public class ExternalCallbackController : ControllerBase
{
    private readonly IDistributedCache _cache;
    // 注入缓存服务，生产环境建议用分布式缓存避免多实例部署问题
    public ExternalCallbackController(IDistributedCache cache)
    {
        _cache = cache;
    }

    [HttpPost("callback")]
    public async Task<IActionResult> HandleCallback([FromBody] ExternalCallbackRequest request)
    {
        // 校验请求签名、处理业务逻辑
        if (!IsValidRequest(request)) return BadRequest();
        
        // 生成临时key存储回调数据，设置5分钟过期
        var tempKey = Guid.NewGuid().ToString("N");
        var cacheOptions = new DistributedCacheEntryOptions
        {
            AbsoluteExpirationRelativeToNow = TimeSpan.FromMinutes(5)
        };
        await _cache.SetStringAsync(tempKey, JsonSerializer.Serialize(request), cacheOptions);
        
        // 直接返回重定向到Blazor结果页
        return Redirect($"/external-callback/result?key={tempKey}");
    }
}

Blazor回调结果页示例：

@page "/external-callback/result"
@inject IDistributedCache Cache
@inject NavigationManager NavManager

<PageTitle>处理中</PageTitle>

<p>正在处理回调请求，请稍候...</p>

@code {
    [SupplyParameterFromQuery(Name = "key")]
    public string? TempKey { get; set; }

    protected override async Task OnInitializedAsync()
    {
        if (string.IsNullOrWhiteSpace(TempKey))
        {
            NavManager.NavigateTo("/error");
            return;
        }

        var cachedData = await Cache.GetStringAsync(TempKey);
        if (string.IsNullOrWhiteSpace(cachedData))
        {
            // 缓存过期或无效，跳错误页
            NavManager.NavigateTo("/error?msg=回调已过期");
            return;
        }

        // 取出数据完成业务处理后，可以按需跳转到其他业务页面
        var callbackData = JsonSerializer.Deserialize<ExternalCallbackRequest>(cachedData);
        // 处理业务逻辑...
        
        NavManager.NavigateTo("/user/dashboard");
    }
}

• 只有当POST回调是用户浏览器直接发起时，直接返回重定向的方案才生效。如果外部站点是从服务端向你的接口发POST请求（没有经过用户浏览器），那这个方案不适用，你需要在收到服务端回调后通过Blazor的电路推送、或客户端轮询的方式通知用户端触发跳转，目前绝大多数第三方支付、OAuth授权类的回调都是浏览器侧发起的，该方案通用。
• 不要在ApiController中尝试注入NavigationManager执行跳转，即使依赖注入容器能提供实例，该实例也没有绑定当前用户的Blazor电路连接，调用NavigateTo方法不会触发用户端的任何跳转行为。
• 不要把敏感的回调数据直接拼在重定向URL的查询参数中，会有数据泄露、URL长度超限的风险，用短时缓存中转是行业通用的稳妥方案。

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