Yii2中AJAX请求时会话过期的重定向处理方案咨询

当Yii2会话过期后，AJAX请求默认会返回403 Forbidden（你提到的402应该是笔误哦），这确实不太友好。我们可以通过两种常见方式来处理：要么返回自定义JSON响应让前端逻辑处理，要么让前端接收到信号后跳转至登录页，下面一步步来拆解实现：

方法一：重写User组件的loginRequired()方法 #

Yii2的User组件在检测到用户需要登录时，会调用loginRequired()方法——默认对AJAX请求返回403状态码。我们可以重写这个方法，给AJAX请求返回更友好的自定义响应：

1. 先在项目的components目录下新建自定义User组件类User.php：

namespace app\components;

use yii\web\User as BaseUser;
use yii\web\Response;

class User extends BaseUser
{
    public function loginRequired($checkAjax = true)
    {
        if ($checkAjax && \Yii::$app->request->isAjax) {
            // 对AJAX请求返回JSON格式的提示信息
            \Yii::$app->response->format = Response::FORMAT_JSON;
            return \Yii::$app->response->data = [
                'success' => false,
                'message' => '会话已过期，请重新登录',
                'redirectUrl' => \Yii::$app->user->loginUrl
            ];
        }
        // 非AJAX请求沿用原有逻辑
        return parent::loginRequired($checkAjax);
    }
}

2. 接着在config/web.php中配置使用这个自定义组件：

'components' => [
    'user' => [
        'class' => 'app\components\User',
        'identityClass' => 'app\models\User',
        'enableAutoLogin' => true,
        'loginUrl' => ['site/login'],
    ],
    // ...其他组件配置
]

这样设置后，AJAX请求遇到会话过期时，就会拿到包含重定向URL的JSON数据，前端可以根据success字段判断状态，再执行跳转或提示。

方法二：修改AccessControl的denyCallback #

如果你不想重写整个User组件，也可以在控制器的AccessControl权限控制行为里，自定义拒绝访问时的回调逻辑：

比如在所有控制器继承的基类BaseController中添加如下配置：

use yii\filters\AccessControl;
use yii\web\Response;

public function behaviors()
{
    $behaviors = parent::behaviors();
    $behaviors['access'] = [
        'class' => AccessControl::class,
        'rules' => [
            // 这里配置你的权限规则，比如仅允许登录用户访问
            [
                'allow' => true,
                'roles' => ['@'],
            ],
        ],
        'denyCallback' => function ($rule, $action) {
            if (\Yii::$app->request->isAjax) {
                \Yii::$app->response->format = Response::FORMAT_JSON;
                \Yii::$app->response->data = [
                    'success' => false,
                    'message' => '请先登录',
                    'redirectUrl' => \Yii::$app->user->loginUrl
                ];
            } else {
                // 非AJAX请求直接跳转登录页
                \Yii::$app->response->redirect(\Yii::$app->user->loginUrl)->send();
            }
        },
    ];
    return $behaviors;
}

这个方法更灵活，可以针对特定控制器或权限规则单独自定义响应逻辑。

前端处理示例（jQuery版） #

拿到后端返回的JSON后，前端可以这样处理状态：

$.ajax({
    url: 'your-ajax-api-url',
    type: 'POST',
    data: yourRequestData,
    success: function(res) {
        if (!res.success) {
            alert(res.message);
            window.location.href = res.redirectUrl;
        } else {
            // 正常处理业务逻辑
            console.log(res.data);
        }
    },
    error: function(xhr) {
        // 兼容可能出现的403状态码
        if (xhr.status === 403) {
            alert('会话已过期，请重新登录');
            window.location.href = '/site/login';
        }
    }
});

注意：AJAX请求本身无法直接触发浏览器重定向，必须由前端接收到响应后手动执行跳转，这是浏览器的安全限制哦。

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