在前后端分离的开发场景中，前端通过AJAX向ASP.NET控制器传递数组数据是常见需求，但不少开发者会遇到415错误，导致请求无法被正确处理。415错误的本质是服务器无法处理请求附带的媒体类型，通常和请求头配置、数据格式、参数绑定规则不匹配有关。
415错误的常见成因
出现415错误主要有以下几个原因：
- 请求头中
Content-Type设置不正确，控制器无法识别请求的数据格式 - AJAX发送的数据没有按照ASP.NET的参数绑定规则进行格式化
- 控制器方法的参数类型与前端传递的数组格式不匹配
- 未正确配置JSON序列化器，导致数组数据无法被反序列化
正确的AJAX请求配置
要解决415错误，首先需要保证AJAX请求的格式符合ASP.NET的接收要求。以下是标准的AJAX请求示例：
// 前端要传递的数组数据
var userIds = [1, 2, 3, 4];
$.ajax({
url: '/User/DeleteUsers', // 控制器接口地址
type: 'POST',
// 设置内容类型为JSON，ASP.NET默认支持JSON格式的反序列化
contentType: 'application/json; charset=utf-8',
// 将数据序列化为JSON字符串，注意数组直接放在对象中传递
data: JSON.stringify({ ids: userIds }),
success: function (res) {
console.log('请求成功，返回结果：', res);
},
error: function (xhr) {
console.log('请求失败，状态码：', xhr.status);
}
});
ASP.NET控制器参数绑定实现
前端请求配置正确后，控制器需要按照对应的规则定义参数，才能完成数组的绑定。以下是两种常见的绑定方式：
方式一：使用自定义类接收数组
定义一个包含数组属性的类，控制器方法直接接收该类的实例：
// 定义接收参数的类
public class UserDeleteModel
{
// 数组属性，名称和前端JSON中的ids对应
public int[] ids { get; set; }
}
// 控制器方法
[HttpPost]
public IActionResult DeleteUsers(UserDeleteModel model)
{
if (model.ids != null && model.ids.Length > 0)
{
// 处理数组数据，比如批量删除用户
foreach (var id in model.ids)
{
// 业务逻辑处理
}
return Ok(new { code = 200, msg = "删除成功" });
}
return BadRequest(new { code = 400, msg = "参数不能为空" });
}
方式二：直接接收数组参数
如果不需要额外的参数，也可以直接在控制器方法中定义数组类型的参数，此时需要保证前端传递的JSON结构和参数匹配：
[HttpPost]
public IActionResult DeleteUsers([FromBody] int[] ids)
{
if (ids != null && ids.Length > 0)
{
// 处理数组数据
return Ok(new { code = 200, msg = "处理成功" });
}
return BadRequest(new { code = 400, msg = "参数不能为空" });
}
注意这种方式下，前端传递的JSON需要直接是数组，而不是包裹在对象中，对应的AJAX数据部分需要修改为：
data: JSON.stringify(userIds),
常见问题排查
如果按照上述配置仍然出现415错误，可以按照以下步骤排查：
- 检查
Content-Type是否为application/json，不要使用application/x-www-form-urlencoded传递JSON数据 - 确认
JSON.stringify是否正确执行，避免传递未序列化的对象 - 检查控制器方法是否添加了
[HttpPost]特性，匹配AJAX的请求类型 - 如果是.NET Framework项目，确认是否配置了JSON序列化器，可在
Global.asax中添加相关配置
注意：如果传递的是复杂对象数组，只需要将数组元素的属性与后端类的属性对应，序列化后传递即可，绑定规则和普通数组一致。
总结
解决AJAX传递数组到ASP.NET控制器的415错误，核心是保证请求头、数据格式、参数定义三者匹配。只要正确设置Content-Type为JSON格式，将数组数据序列化为符合规则的JSON字符串，再配合控制器正确的参数定义，就能顺利完成数据绑定，避免415错误的出现。