X-Redirect 是 Yii 在 AJAX 中提示前端跳转的约定头，需前端主动读取并执行跳转；后端不强制重定向，浏览器也不自动响应，且 JSON 响应格式下默认不设置该头。
Yii 中 X-Redirect 响应头不是给前端自动跳转用的
它只是 Yii 在 AJAX 请求中「提示前端该跳去哪里」的一种约定，后端不会强制重定向，浏览器也不会自动响应。真正起作用的是你前端 JS 怎么读这个头、怎么处理。
常见错误现象：fetch 或 jQuery.ajax 收到 200 响应，X-Redirect 头存在，但页面没跳转——因为没人读它、没人调 window.location.href。
- 只在
yii\web\Response::redirect()被用于 AJAX 场景时自动设置，且仅当请求头含X-Requested-With: XMLHttpRequest - 值是完整 URL（如
/admin/dashboard），不是相对路径或状态码 - 如果 action 返回 JSON 数据同时又调了
$this->redirect()，Yii 默认会忽略 redirect（因已输出内容），X-Redirect不会出现
如何让 X-Redirect 真正生效：前端必须主动检查
Yii 不接管前端行为，所以你得在 JS 里手动读响应头并跳转。不同请求方式处理逻辑不同：
-
fetch：需显式调response.headers.get('X-Redirect')，不能靠redirect: 'follow'（那是 HTTP 重定向，和这个头无关） -
jQuery.ajax：在success或complete回调里用xhr.getResponseHeader('X-Redirect') - 如果用了封装库（如 axios），注意它默认不暴露自定义响应头，需后端加
Access-Control-Expose-Headers: X-Redirect
简单示例（fetch）：
fetch('/login', { method: 'POST', body: fd })
.then(r => {
const redirect = r.headers.get('X-Redirect');
if (redirect) return window.location.href = redirect;
return r.json();
});
X-Redirect 和 HTTP 302 重定向的区别与取舍
两者目标相似，但机制完全不同：一个靠前端配合，一个靠浏览器自动执行。
- 用
X-Redirect：适合需要统一处理 AJAX 跳转逻辑的项目（比如弹窗登录后跳回原页），避免服务端对非 AJAX 请求也返回 302 导致页面白屏 - 用 HTTP 302：简单直接，但 AJAX 下会被 fetch/jQuery 拦截（除非设
redirect: 'manual'），且无法携带额外跳转参数 - 性能无差异，但兼容性上：所有现代浏览器都支持读取响应头；而某些老旧安卓 WebView 对
getResponseHeader支持不稳定
容易被忽略的 Yii 配置点：JSON 响应下 X-Redirect 不出现
如果你的控制器 action 里写了 $this->redirect('/home')，但同时又用了 Yii::$app->response->format = \yii\web\Response::FORMAT_JSON，那 X-Redirect 头根本不会发出。
- 原因：Yii 的 redirect 逻辑在 format 为 JSON 时被跳过（认为你要返回数据，不是跳转）
- 解决办法：要么改用普通 HTML 响应格式，要么手动设头：
Yii::$app->response->headers->set('X-Redirect', '/home') - 另一个坑：
beforeAction或行为（Behavior）里提前exit或throw HttpException，也会导致 redirect 中断，X-Redirect不生效
