Postman调用Symfony GET接口正常但AJAX请求返回500错误如何解决

核心错误点 #

• GET 请求传递了JSON格式的请求体：HTTP规范中GET请求的参数默认通过URL查询字符串传递，包括Symfony在内的绝大多数服务端框架默认不会解析GET请求的请求体内容。你将参数序列化后放在请求体中提交，后端无法正常获取id、week、year等必填参数，会因参数校验失败、业务逻辑异常返回500错误。
• 多余配置了contentType: "application/json"：该字段用于指定请求体的格式，GET请求无需携带请求体，该配置属于冗余配置，还会干扰服务端对请求格式的判断。

修复方案 #

你可以根据接口的实际用途任选一种方案修改：

方案1：将请求改为POST类型（更符合数据提交场景的REST规范） #

前端修改AJAX配置即可：

$('#testButton').click(function (e) {
    let week = 42;
    let year = 2021;
    let data = JSON.stringify({
        id:1,
        week: week,
        year: year
    });
    $.ajax({
        url: '{{ path('bookings')}}',
        type: 'POST', // 仅修改请求类型即可
        contentType: "application/json",
        dataType: 'json',
        data: data,
        success: function (data, status) {
            console.log(status)
            if (status === 'success') {
                console.log(data);
                console.log('success');
            } else {
                console.log('failure');
            }
        }
    });
});

同时需要修改Symfony端的bookings路由，使其支持POST请求，控制器中使用$request->toArray()方法即可解析获取JSON格式的请求参数。

方案2：保留GET请求类型，调整参数传递格式 #

直接传递普通JS对象作为请求参数，jQuery会自动将参数拼接为URL查询字符串，无需序列化：

$('#testButton').click(function (e) {
    let week = 42;
    let year = 2021;
    // 去掉JSON序列化，直接传递普通对象
    let data = {
        id:1,
        week: week,
        year: year
    };
    $.ajax({
        url: '{{ path('bookings')}}',
        type: 'GET',
        // 移除多余的contentType配置
        dataType: 'json',
        data: data,
        success: function (data, status) {
            console.log(status)
            if (status === 'success') {
                console.log(data);
                console.log('success');
            } else {
                console.log('failure');
            }
        }
    });
});

修改后Symfony控制器中使用$request->query->get('参数名')即可正常获取请求参数。

排查小技巧 #

后续遇到同类接口500错误，可以直接查看Symfony的运行日志，日志中会明确记录错误的具体原因（比如参数缺失、变量未定义等），可以大幅提升排查效率。

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