Blazor Server项目无法正常配置Controller问题求助

1. 修正中间件配置顺序（核心问题） #

Blazor 的 fallback 路由会拦截所有未匹配的请求，必须将控制器相关的端点映射放在 Blazor 相关映射之前，同时禁止混用旧版 Mvc 中间件。

如果你用 .NET 6+ 顶层语句的 Program.cs #

正确配置示例：

var builder = WebApplication.CreateBuilder(args);

// 注册控制器服务
builder.Services.AddControllers();
// 保留原有Blazor相关服务
builder.Services.AddRazorPages();
builder.Services.AddServerSideBlazor();

var app = builder.Build();

// 基础中间件按原有顺序配置即可
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
    app.UseHsts();
}
app.UseHttpsRedirection();
app.UseStaticFiles();
app.UseRouting();
app.UseAuthorization();

// --- 控制器映射必须放在Blazor映射之前 ---
app.MapControllers();
// 测试端点也放在这个位置
app.MapGet("/aaa", async context => await context.Response.WriteAsync("Hello World!"));

// --- Blazor相关映射放在最后 ---
app.MapBlazorHub();
app.MapFallbackToPage("/_Host");

app.Run();

如果你用旧版 Startup.cs 配置 #

public void ConfigureServices(IServiceCollection services)
{
    // 注册控制器服务
    services.AddControllers();
    // 保留原有Blazor服务
    services.AddRazorPages();
    services.AddServerSideBlazor();
}

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    // 保留原有基础中间件配置：UseHttpsRedirection、UseStaticFiles、UseRouting、UseAuthorization等

    app.UseEndpoints(endpoints =>
    {
        // --- 控制器映射放在Blazor映射之前 ---
        endpoints.MapControllers();
        endpoints.MapGet("/aaa", async context => await context.Response.WriteAsync("Hello World!"));
        
        // --- Blazor相关映射放在最后 ---
        endpoints.MapBlazorHub();
        endpoints.MapFallbackToPage("/_Host");
    });
}

注意：删除所有app.UseMvc()、app.UseMvcWithDefaultRoute()配置，.NET Core 3.0+ 与 Blazor Server 配套使用端点路由，混用Mvc中间件会导致路由冲突。

2. 检查控制器定义规范 #

控制器必须符合以下要求才会被框架扫描到：

• 类的访问修饰符为public
• 继承ControllerBase（纯API无需继承带视图支持的Controller类）
• 标注[ApiController]和路由特性，示例如下：

[ApiController]
[Route("api/[controller]")]
public class TestController : ControllerBase
{
    [HttpGet]
    public IActionResult GetTestContent()
    {
        return Ok("控制器调用成功");
    }
}

测试请求地址为https://你的应用地址/api/test，确认地址与路由配置匹配。

3. 其他常见问题排查 #

• 确认Postman请求使用的协议和应用启动的协议一致，如果你开启了HTTPS重定向，用HTTP请求会导致跳转异常甚至超时，直接用HTTPS地址测试。
• 不要自定义与Blazor系统路由重名的接口路径，避免路由匹配冲突。
• 检查是否有其他自定义中间件拦截了API请求，导致请求无法到达控制器端点。

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