Blazor项目中Razor页面构造函数及方法未触发问题求助

核心问题分析 #

你遇到的Razor页面构造函数、OnGet/OnPost方法未触发，大概率是混淆了Blazor组件与Razor Pages的使用逻辑，或是基础配置缺失导致Razor Pages未被正确托管。Razor Pages属于MVC生态的页面模型，不能像Blazor组件那样直接在组件中引用，必须通过路由访问才能触发其生命周期方法。

分步排查与修复 #

1. 确认Razor Pages基础配置 #

检查Program.cs（或Startup.cs）是否正确配置了Razor Pages的服务与中间件：

// Program.cs
var builder = WebApplication.CreateBuilder(args);

// 添加Razor Pages服务
builder.Services.AddRazorPages();
// 添加Blazor服务（根据项目类型选择Server/WASM）
builder.Services.AddServerSideBlazor(); // 或 AddBlazorWebAssembly()

var app = builder.Build();

if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
    app.UseHsts();
}

app.UseHttpsRedirection();
app.UseStaticFiles();
app.UseRouting();
app.UseAuthorization();

// 必须添加这行，启用Razor Pages路由
app.MapRazorPages();
// Blazor相关路由配置
app.MapBlazorHub();
app.MapFallbackToPage("/_Host"); // WASM项目替换为MapFallbackToFile("/index.html")

app.Run();

2. 修正Login页面的代码结构 #

确保Login.cshtml.cs继承自PageModel，并正确实现重定向逻辑：

// Login.cshtml.cs
using Microsoft.AspNetCore.Mvc;
using Microsoft.AspNetCore.Mvc.RazorPages;

public class LoginModel : PageModel
{
    private readonly IConfiguration _configuration;

    public LoginModel(IConfiguration configuration)
    {
        _configuration = configuration;
    }

    public async Task<IActionResult> OnGetAsync()
    {
        var googleLoginUrl = _configuration["Authentication:Google:LoginUrl"];
        
        if (string.IsNullOrEmpty(googleLoginUrl))
        {
            return BadRequest("Google登录地址未配置");
        }

        return Redirect(googleLoginUrl);
    }
}

对应的Login.cshtml只需保留基础路由定义（因重定向无需渲染页面）：

@page "/login"
@model LoginModel

3. 修正LoginControl组件的调用方式 #

禁止直接在Blazor组件中引用Razor Pages（如<Login />），需通过NavigationManager导航到目标路由：

<!-- LoginControl.razor -->
@inject NavigationManager NavManager

<button @onclick="NavigateToLogin">Google登录</button>

@code {
    private void NavigateToLogin()
    {
        // 导航到Razor Pages路由，触发OnGetAsync方法
        NavManager.NavigateTo("/login");
    }
}

4. 验证路由与访问逻辑 #

• 直接在浏览器地址栏访问/login，若能触发重定向，说明Razor Pages配置正常；
• 点击LoginControl组件的按钮，检查是否跳转到/login并触发重定向；
• 若构造函数仍未触发，检查依赖注入逻辑（IConfiguration为默认注册服务，通常不会出现问题）。

额外注意点 #

• Razor Pages的路由由@page指令定义，@page "/login"对应路由/login，需避免与Blazor组件路由冲突；
• Blazor WASM项目中，Razor Pages需托管在ASP.NET Core后端，无法直接在客户端运行；
• 若需在Blazor中处理认证，也可使用Blazor自带认证组件，但用Razor Pages作为Google登录跳转入口是合理方案。

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