Yii2中AJAX请求调用控制器redirect函数报错问题排查

问题原因 #

前端AJAX请求期望接收2xx成功状态码的响应，但Yii2的redirect()方法返回的是3xx重定向状态码（通常为302）。jQuery的AJAX会将非2xx的HTTP状态码判定为请求失败，因此触发error回调——即使浏览器自动跟随重定向获取到目标页面的HTML内容，只要初始响应是3xx状态，AJAX仍会判定请求失败。

替代实现方案 #

方案1：后端返回JSON响应，前端手动跳转 #

适合需要在跳转前执行前端逻辑（比如提示用户、清理页面状态）的场景。

后端Yii2代码修改：

public function actionSaveChanges()
{
    $post = \Yii::$app->request->post();
    $this->Posts->updateFields($post['request_id'], $post);

    // 设置响应格式为JSON
    \Yii::$app->response->format = \yii\web\Response::FORMAT_JSON;
    return [
        'success' => true,
        'redirectUrl' => '/posts'
    ];
}

前端AJAX代码修改：

requestSend: function(e)
{
    let data = {
        request_id: e.target.dataset.request_id
    };
    $.ajax(
    {
        url: '/posts/save-changes',
        method: 'post',
        dataType: 'json', // 匹配后端返回的JSON格式
        data: data,
        success: function(res)
        {
            if (res.success) {
                console.log('success');
                // 前端手动执行页面跳转
                window.location.href = res.redirectUrl;
            }
        },
        error: function()
        {
            console.log('error');
        }
    });
},

方案2：后端直接返回成功状态的HTML内容 #

如果不需要跳转，仅需返回操作成功的提示内容（比如页面片段），可以直接渲染HTML返回。

public function actionSaveChanges()
{
    $post = \Yii::$app->request->post();
    $this->Posts->updateFields($post['request_id'], $post);

    // 渲染成功提示的视图片段（需提前创建对应的视图文件）
    return $this->renderPartial('_success', [
        'message' => '修改已成功保存'
    ]);
}

前端保持dataType: 'html'，成功后可将返回的HTML插入到页面指定位置（比如弹窗、提示区域）。

方案3：后端返回200状态的重定向内容（不推荐） #

这种方式通过设置响应状态码为200，同时返回HTML跳转代码，不符合HTTP规范，仅适用于特殊兼容场景：

public function actionSaveChanges()
{
    $post = \Yii::$app->request->post();
    $this->Posts->updateFields($post['request_id'], $post);

    // 设置状态码为200，返回meta刷新实现跳转
    \Yii::$app->response->statusCode = 200;
    return '<meta http-equiv="refresh" content="0;url=/posts">';
}

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