本地正常的AJAX请求在生产环境无法获取后端参数

核心问题 #

AJAX POST请求在本地环境能正常传递参数到后端，但生产环境中后端无法获取参数值，触发inscricao为Null的错误；同一页面内其他POST请求无异常，尝试过CSRF相关处理（请求头传token、data中带token、添加[IgnoreAntiForgeryToken]特性）均无效。

可能原因及排查/解决步骤 #

1. 数据格式与Content-Type不匹配 #

你的AJAX设置了datatype: "application/json"，但jQuery默认会把对象形式的data以application/x-www-form-urlencoded格式发送，而非JSON。如果后端期望接收JSON格式，就会解析失败导致参数为空。

解决方法：
显式设置contentType并将data转为JSON字符串：

$.ajax({
    type: 'post',
    beforeSend: function (xhr) {
        xhr.setRequestHeader("XSRF-TOKEN",
            $('[name="__RequestVerificationToken"]').val());
    },
    url: '?handler=SolicitarSafe2Pay',
    contentType: "application/json", // 明确指定JSON格式
    dataType: "json", // 修正为标准驼峰写法
    data: JSON.stringify({ // 将参数转为JSON字符串
        valor: valortotal,
        IDInscricao: Number(inscricaoID),
        HtmlResumo: resumoemail,
        IDCupom: idUsoUnico,
        Nome: $Nome.val(),
        NomeSocial: $NomeSocial.val(),
        CPF: $CPF.val(),
        Telefone: $Telefone.val(),
        CEP: $CEP.val(),
        Pais: $Pais.val(),
        Estado: $Estado.val(),
        Cidade: $Cidade.val(),
        Endereco: $Endereco.val(),
        Numero: $Numero.val(),
        Bairro: $Bairro.val(),
        Complemento: $Complemento.val(),
        FormaPagamento: Number($FormaPagamento.val()),
        NomeCartao: $NomeCartao.val(),
        NumeroCartao: $NumeroCartao.val(),
        CVV: $CVV.val(),
        Vencimento: $Vencimento.val(),
        Parcelas: Number($Parcelas.val())
    }),
    success: function (data) {
        ...
    },
    error: function (xhr, status, error) {
        console.log(xhr);
    }
});

后端对应方法需添加[FromBody]特性接收JSON参数（以ASP.NET Core为例）：

public IActionResult OnPostSolicitarSafe2Pay([FromBody] YourRequestModel model)
{
    // 业务逻辑处理
}

2. 参数大小写绑定不匹配 #

部分后端框架在生产环境可能启用严格的大小写匹配，若AJAX参数是IDInscricao，但后端模型属性为IdInscricao（小写开头的驼峰），会导致参数绑定失败。

解决方法：

• 统一前后端参数大小写：将AJAX中的IDInscricao改为idInscricao；
• 或在后端模型属性上添加特性指定匹配名称：

[JsonPropertyName("IDInscricao")]
public int IDInscricao { get; set; }

3. 生产环境请求拦截/过滤 #

生产环境的反向代理（如Nginx、IIS）或WAF（Web应用防火墙）可能修改、过滤了请求参数，导致部分参数丢失。

排查方法：

• 打开浏览器开发者工具「网络」面板，查看请求的Payload，确认参数是否完整发送；
• 查看生产环境服务器的请求日志，检查原始请求内容是否包含所有参数；
• 临时关闭WAF或调整代理转发规则，测试是否恢复正常。

4. 参数值的特殊字符编码问题 #

生产环境中某些参数（如HtmlResumo的HTML内容）可能包含未转义的特殊字符，导致解析失败。

解决方法：
对特殊参数进行URL编码：

HtmlResumo: encodeURIComponent(resumoemail),

后端接收后再进行解码处理。

5. CSRF Token传递方式不符合生产环境要求 #

部分生产环境对CSRF Token的请求头或参数命名有严格要求，比如ASP.NET Core默认期望的请求头是RequestVerificationToken而非XSRF-TOKEN。

修正方法：
改用标准请求头传递：

beforeSend: function (xhr) {
    xhr.setRequestHeader("RequestVerificationToken",
        $('[name="__RequestVerificationToken"]').val());
},

或直接将Token放入data对象中：

data: {
    __RequestVerificationToken: $('[name="__RequestVerificationToken"]').val(),
    // 其他参数...
}

快速验证步骤 #

1. 对比本地与生产环境的请求Payload、Content-Type是否一致；
2. 在生产环境后端添加日志，输出接收到的原始请求内容，确认参数是否到达服务器；
3. 简化AJAX参数，只保留IDInscricao等核心参数，测试是否能正常传递，逐步排查问题参数。

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