.NET Core 6中FormUrlEncodedContent传递Web API多参数失败问题

1. API接口参数绑定配置缺失 #

你的validateUser接口大概率没正确配置表单参数的绑定规则。.NET Core默认会从URL查询字符串绑定普通参数，而非请求体里的表单数据。如果接口方法的参数没加[FromForm]特性，就会导致FormUrlEncodedContent传递的请求体参数无法被解析，而URL里的参数能被正常识别。

修正示例：

// 单个参数绑定
[HttpPost("validateUser")]
public IActionResult ValidateUser([FromForm] string email, [FromForm] string password)
{
    // 业务逻辑代码
}

// 或使用DTO类绑定
public class LoginDto
{
    public string Email { get; set; }
    public string Password { get; set; }
}

[HttpPost("validateUser")]
public IActionResult ValidateUser([FromForm] LoginDto loginDto)
{
    // 业务逻辑代码
}

2. 请求头Content-Type被意外修改 #

虽然FormUrlEncodedContent会自动设置Content-Type: application/x-www-form-urlencoded，但如果代码中意外覆盖或修改了请求头，服务器就无法识别请求体格式。可以显式确认请求头设置：

var formData = new Dictionary<string, string>
{
    {"email", "test@example.com"},
    {"password", "123456"}
};
var content = new FormUrlEncodedContent(formData);
// 显式声明（可选，默认已设置，用于排查问题）
content.Headers.ContentType = new MediaTypeHeaderValue("application/x-www-form-urlencoded");
var response = await httpClient.PostAsync("api/validateUser", content);

3. 浏览器跨域（CORS）拦截 #

Postman不会触发预检请求，但浏览器会。如果API未正确配置CORS策略，请求会被浏览器拦截，表现为参数传递失败。检查API的CORS配置，确保允许前端域名及对应请求头：

// Program.cs中配置CORS
builder.Services.AddCors(options =>
{
    options.AddPolicy("AllowFrontend", policy =>
    {
        policy.WithOrigins("https://你的前端域名.com")
              .AllowAnyMethod()
              .AllowAnyHeader();
    });
});

app.UseCors("AllowFrontend");

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