.NET Core DataTables Ajax向服务器传参为null的问题排查

问题场景 #

前端使用DataTables实现服务端分页，代码如下：

<script>
    $(document).ready(function () {
        $("#example").dataTable({
            pageLength: 10,
            dom: '<"html5buttons"B>lTfgitp',
            buttons: [
                { extend: 'excel', title: 'ExampleFile' }
            ],
            "processing": true,
            "serverSide": true,
            ajax: {
                type: "POST",
                url: "url",
                contentType: "application/json; charset=utf-8",
                dataType: "jsonObject",
                data: function (dtparams) {
                    return JSON.stringify(dtparams);
                },
                dataFilter: function (res) {
                    var parsed = JSON.parse(res);
                    return JSON.stringify(parsed.d);
                },
                error: function (x, y) {
                    console.log(x);
                },
                "filter": true,
                columns: [
                //columns
                ],
            }
        })
    })
</script>

后端对应接收方法：

public async Task<IActionResult> GetFilteredItems(string clientParameters)
{
    // Code
}

调试时前端能看到完整的参数对象，但后端clientParameters始终为null。

解决思路 #

• 修正后端参数接收逻辑：
  前端发送的是结构化JSON对象，而非单一字符串，直接用string类型无法自动绑定。需按以下步骤调整：

  1. 创建匹配DataTables请求结构的模型类：

     public class DataTablesRequest
     {
         public int Draw { get; set; }
         public int Start { get; set; }
         public int Length { get; set; }
         // 按需添加其他参数，如Search、Columns等DataTables默认字段
     }
     

  2. 修改后端方法，使用模型类接收并添加[FromBody]特性，明确从请求体读取JSON：

     public async Task<IActionResult> GetFilteredItems([FromBody] DataTablesRequest clientParameters)
     {
         // 业务代码
     }
     

• 调整前端AJAX配置：

  1. 将dataType: "jsonObject"改为dataType: "json"，jQuery中无jsonObject这个合法类型，错误配置会导致解析异常。
  2. 保留contentType: "application/json; charset=utf-8"，确保请求头正确标识数据格式。
  3. 若后端为ASP.NET Core，确认项目已配置JSON序列化支持（默认已包含，自定义配置时需检查是否存在冲突）。

• 验证请求完整性：
  用浏览器开发者工具的Network面板查看请求Payload，确认发送的JSON格式无语法错误。若格式正常仍无法接收，可在后端添加日志输出原始请求体，排查参数绑定问题。

• 移除多余的dataFilter配置：
  若后端返回的是DataTables直接兼容的JSON结构（无外层d属性），当前的dataFilter会修改响应内容导致解析失败，可先注释该配置后测试参数接收情况。

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