ASP.NET+React项目结构变更后无法调用控制器的解决办法

关键：纠正路由匹配错误 #

ASP.NET Core的[controller]路由占位符会自动移除控制器类名的Controller后缀。你的控制器类名为MyController，所以[controller]会被替换为My，结合[action]的GetAll，完整的路由路径是**/My/GetAll**，而非你当前使用的MyController/GetAll。
如果之前项目能正常调用，大概率是之前的路由配置不同（比如直接用固定路由[Route("MyController/[action]")]），结构变更后路由规则恢复默认，导致URL不匹配。

1. 验证后端路由可用性 #

直接在浏览器或Postman中访问后端路由（如http://localhost:5000/My/GetAll）：

• 若返回true：后端配置正常，问题出在前端请求
• 若返回404：后端路由未正确注册，继续以下排查

2. 确认控制器注册配置 #

检查Program.cs中是否包含必要的API控制器服务和路由配置：

var builder = WebApplication.CreateBuilder(args);

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

var app = builder.Build();

// 必须启用控制器路由（放在app.Run()之前）
app.MapControllers();

app.Run();

如果控制器移到了独立类库，需额外添加程序集扫描：

builder.Services.AddControllers()
    .AddApplicationPart(typeof(MyController).Assembly);

3. 排查跨域问题（前后端分离场景） #

如果React前端和后端不在同一域名/端口，需在后端配置CORS：

builder.Services.AddCors(options =>
{
    options.AddPolicy("AllowReactApp",
        policy => policy.WithOrigins("http://localhost:3000") // 替换为你的React项目地址
                        .AllowAnyHeader()
                        .AllowAnyMethod());
});

// 在app.MapControllers()前启用CORS
app.UseCors("AllowReactApp");

4. 检查前端请求细节 #

打开浏览器开发者工具（F12）的网络面板：

• 确认请求URL是否为正确的/My/GetAll（同域）或完整跨域地址（如http://localhost:5000/My/GetAll）
• 查看请求状态码：
  • 405：HTTP方法不匹配（确认前端用的是GET请求）
  • CORS错误：检查跨域配置是否生效
  • 404：路由仍不匹配，回到后端路由排查

5. 启用日志定位问题 #

在appsettings.json中开启路由调试日志，查看控制器注册和请求匹配细节：

{
  "Logging": {
    "LogLevel": {
      "Microsoft.AspNetCore.Routing": "Debug",
      "Microsoft.AspNetCore.Mvc": "Debug"
    }
  }
}

启动后端后，查看控制台日志，确认控制器是否被成功注册，以及请求到达时的路由匹配过程。

内容的提问来源于stack exchange，提问作者josé djalma