ASP.NET 6 Minimal API无法处理Vue3应用的接口请求问题

中间件执行顺序错误是核心诱因。ASP.NET Core 中间件严格按照代码注册的先后顺序执行，你当前的代码中UseSpa代理中间件的注册位置早于端点执行逻辑：框架自动注入的端点执行中间件默认会放在管道最末尾，所有/api前缀的接口请求还没被Minimal API匹配处理，就被SPA代理直接转发到Vue开发服务器（http://localhost:3000），Vue端没有匹配对应路由就返回入口HTML，最终表现为接口路径也渲染Vue应用内容。

调整中间件顺序，显式让API端点的匹配执行优先级高于SPA代理，确保接口请求不会被代理拦截。
修正后的Program.cs代码如下：

var builder = WebApplication.CreateBuilder(args);
// 你的其他服务注册代码（比如AddCors、AddAuthorization等）保持不变

var app = builder.Build();

// 1. 先注册路由中间件
app.UseRouting();

// 2. 注册所有API端点，和原有写法一致
app.MapGet("/api/my-endpoint", () =>
{
    return "Hello world from API";
});

// 3. 显式注册端点执行中间件，必须放在UseSpa之前
// 匹配到API端点的请求会在这里直接返回，短路后续管道
app.UseEndpoints(_ => { });

// 开发环境SPA代理放在端点执行逻辑之后
if (app.Environment.IsDevelopment())
{
    app.UseSpa(spaBuilder =>
    {
        spaBuilder.UseProxyToSpaDevelopmentServer("http://localhost:3000");
    });
}

app.Run();

可选双重保险配置 #

如果后续还需要新增其他非API的后端端点，可以通过MapWhen给SPA代理加路径过滤，仅非/api前缀的请求才走SPA代理，避免后续调整中间件顺序时再次出现拦截问题：

if (app.Environment.IsDevelopment())
{
    // 仅路径不以/api开头的请求进入SPA代理分支
    app.MapWhen(context => !context.Request.Path.StartsWithSegments("/api"), spaPipeline =>
    {
        spaPipeline.UseSpa(spaBuilder =>
        {
            spaBuilder.UseProxyToSpaDevelopmentServer("http://localhost:3000");
        });
    });
}

• 启动应用后访问http://localhost:5000，Vue应用正常加载
• 直接访问http://localhost:5000/api/my-endpoint，可正常返回Hello world from API接口响应
• Vue应用内发起的所有/api前缀请求，都会被.NET后端正确处理，不会再返回Vue页面内容

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