PHP 8.4 中接口请求完成后不应重定向，因其破坏 API 合约：服务端 header("Location") 导致前端收到 302 空响应；应通过请求头或路径判断是否为 API 请求，仅对页面请求重定向，接口则返回标准 JSON（含状态码、数据或 redirect 指令），登录失败时返回 401 + login_url。
PHP 8.4 中接口请求完成后，**不应重定向**——这是关键前提。接口（如 RESTful API）的职责是返回结构化数据（通常是 JSON），而非跳转页面。若在接口逻辑里执行 header("Location: ...")，会导致前端收到 302 状态码和空响应体，破坏 API 合约，引发前端解析失败或“请求被重定向但无数据”的假错误。
为什么接口里不能用 header() 重定向
服务端重定向本质是 HTTP 层面的控制流转移，适用于页面导航场景（如表单提交后跳转 success.php）。而接口调用者（如 Axios、fetch 或移动端 SDK）默认不跟随重定向，或需显式配置 redirect: 'follow' 才能处理；即使跟随，也意味着两次网络往返、丢失原始响应数据、无法携带业务状态码（如 201 Created）和 JSON payload。
正确做法：区分接口与页面请求
通过请求头或路径特征判断是否为 API 调用，仅对普通页面请求启用重定向：
- 检查
$_SERVER['HTTP_ACCEPT']是否包含application/json或application/vnd.api+json - 检查请求路径是否以
/api/开头（如$_SERVER['REQUEST_URI']） - 统一约定接口返回标准 JSON 响应，例如：
<?php
if (is_api_request()) {
http_response_code(200);
header('Content-Type: application/json; charset=utf-8');
echo json_encode(['status' => 'success', 'data' => $result]);
exit;
}
// 否则走页面逻辑，可安全重定向
header('Location: /dashboard');
exit;
?>
如果真需要跳转，由前端控制
服务端只返回跳转指令，不执行重定向：
立即学习“PHP免费学习笔记（深入）”；
- 接口响应中增加字段：
"redirect": "/success" - 前端收到后调用
window.location.href = response.redirect或router.push()（Vue/React） - 优势：完全可控、不依赖 HTTP 状态码、兼容所有客户端、便于埋点和异常拦截
特殊情况：登录鉴权失败时的“伪重定向”
当接口检测到未登录，不应返回 302，而应返回明确状态：
-
http_response_code(401)+ JSON：{"error": "unauthorized", "login_url": "/login?from=" . urlencode($_SERVER['REQUEST_URI'])} - 前端捕获 401，读取
login_url并跳转，同时保留来源页，实现体验等效于服务端重定向
