React与ASP.NET Core 8中[FromBody]引发CORS及路由歧义异常原因

错误根源分析 #

1. 端点歧义（AmbiguousMatchException）：
   你修改AllMeals方法添加参数后，大概率是编译缓存没清理干净，导致旧的无参数版本和新的带参数版本同时存在于程序集中，路由系统无法区分两个相同路由的方法。另外，直接用[FromBody] string date绑定前端发送的JSON对象也会导致绑定失败，间接引发路由匹配问题。
2. CORS错误：这是后端异常的次生问题——当后端抛出端点歧义异常时，CORS中间件还没来得及给响应头添加Access-Control-Allow-Origin，前端就收到了错误响应，从而触发CORS拦截。

解决步骤 #

1. 清理编译缓存，重建项目 #

• 手动删除项目根目录下的bin和obj文件夹
• 用命令行执行dotnet clean && dotnet build，或者重启IDE后重新构建
• 确保MealController中只有一个AllMeals方法，没有重复定义

2. 修正[FromBody]参数绑定 #

前端发送的是{date: "ISO日期字符串"}格式的JSON对象，直接用string date无法正确绑定请求体。需要创建一个模型类来接收：

// 新建Models/DateRequest.cs
namespace Fitness_Tracker.Models
{
    public class DateRequest
    {
        public string Date { get; set; }
    }
}

然后修改控制器的AllMeals方法：

[HttpPost("all")]
public async Task<IActionResult> AllMeals([FromBody] DateRequest request)
{
    if (request == null || string.IsNullOrWhiteSpace(request.Date))
    {
        return BadRequest("日期参数无效");
    }

    string userId = User.FindFirst(ClaimTypes.NameIdentifier)?.Value;
    if (userId == null)
    {
        return BadRequest();
    }

    // 记得同步修改MealService的GetAllUserMealsAsync方法，添加date参数做过滤
    List<Meal> result = await _mealService.GetAllUserMealsAsync(userId, request.Date);

    return Ok(result);
}

3. 确认CORS配置正确性 #

在Program.cs中确保CORS策略正确允许前端域名，并且支持凭据传递：

var builder = WebApplication.CreateBuilder(args);

// 配置CORS
builder.Services.AddCors(options =>
{
    options.AddPolicy("AllowReactApp", policy =>
    {
        policy.WithOrigins("http://localhost:3000")
              .AllowAnyHeader()
              .AllowAnyMethod()
              .AllowCredentials(); // 必须开启，匹配前端的credentials: 'include'
    });
});

builder.Services.AddControllers();

var app = builder.Build();

// 注意中间件顺序：UseRouting之后，UseAuthorization之前启用CORS
app.UseRouting();
app.UseCors("AllowReactApp");
app.UseAuthorization();

app.MapControllers();

app.Run();

4. 验证前端请求 #

前端的fetch请求已经正确发送JSON格式的日期参数，无需修改，确认selectedDate.toISOString()生成的是标准ISO格式字符串即可。

完成以上操作后，重启前后端项目，就能正常通过[FromBody]接收日期参数，同时解决端点歧义和CORS错误。

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