Blazor Web App(ASP.NET Core 8.0)控制器路由无法找到问题排查

1. 核对控制器的路由特性配置 #

确保FilesController上正确配置路由特性，示例代码如下：

[ApiController]
[Route("api/[controller]")]
public class FilesController : ControllerBase
{
    [HttpGet("download")]
    public IActionResult DownloadFile()
    {
        // 示例下载逻辑
        var filePath = "指定你的文件路径";
        var fileName = "test-file.txt";
        return PhysicalFile(filePath, "application/octet-stream", fileName);
    }
}

• 必须添加[ApiController]特性，这是ASP.NET Core识别API控制器的核心标记
• 基础路由通过[Route]定义，比如api/files，结合方法的download路由，最终访问URL应为https://localhost:<端口号>/api/files/download

2. 确认Program.cs的中间件顺序 #

Blazor Web App的中间件顺序直接影响路由匹配，MapControllers必须放在MapRazorComponents之前，否则请求会被Blazor路由系统拦截，正确配置示例：

var builder = WebApplication.CreateBuilder(args);

// 注册控制器服务
builder.Services.AddControllers();

// 注册Blazor组件服务
builder.Services.AddRazorComponents()
    .AddInteractiveServerComponents();

var app = builder.Build();

// 静态文件、防伪造等中间件
app.UseStaticFiles();
app.UseAntiforgery();

// 优先映射控制器路由
app.MapControllers();

// 再映射Blazor组件路由
app.MapRazorComponents<App>()
    .AddInteractiveServerRenderMode();

app.Run();

3. 检查控制器的命名空间与位置 #

确保FilesController所在的Controllers目录命名空间正确，ASP.NET Core默认会扫描项目中所有继承自ControllerBase/Controller的类，若手动限制了扫描范围，需确认控制器被包含在内。

4. 验证访问URL的正确性 #

• 核对端口号与项目启动配置（可在Properties/launchSettings.json中查看）
• 避免URL大小写冲突（ASP.NET Core路由默认不区分大小写，但尽量与路由定义保持一致）
• 若启用HTTPS，确保使用https://协议访问

5. 排查全局路由约束或前缀 #

如果Program.cs中配置了全局路由前缀或约束，需确保访问URL符合规则。例如配置了全局api前缀时，URL必须包含该前缀。

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