如何设置ThinkPHP伪静态实现旧链接301跳转兼容？

本文共计1165个文字，预计阅读时间需要5分钟。

旧链接无法直接访问，需进行301重定向到新伪静态地址，否则SEO权重会丢失。ThinkPHP伪静态本身体不处理跳转，需依赖Web服务器（Nginx/Apache）或PHP层主动解析重定向——两者需配合，漏掉一个环节则301失效。

ThinkPHP 路由开启后，旧动态 URL 还能访问吗

能，但默认不会自动跳转。比如 index.php?m=home&c=user&a=info&id=123 在开启 URL_ROUTER_ON 后仍可直访，除非你显式拦截并重定向。

• ThinkPHP 不会自动把旧 URL 301 到新路由地址，它只负责「解析新 URL → 执行对应逻辑」
• 如果你已上线过动态 URL，现在切伪静态，搜索引擎和老用户书签还在用旧地址，这些请求必须被接管
• 判断是否需要跳转：看 $_SERVER['REQUEST_URI'] 是否匹配 index.php? 开头，且不含 / 分隔的 PATH_INFO 风格路径
• 不要在控制器里做跳转 —— 太晚，可能已输出 HTML，触发 headers already sent

Nginx 配置中如何拦截旧 URL 并 301 到新地址

必须在 location ~ \.php$ 块之前加一层判断，用 if 拦截含 ? 的请求，再用 rewrite 生成新路径。注意：Nginx 的 if 有作用域限制，不能嵌套在 location 内再写 rewrite 到外部 location。

• 在 server 块顶层加这段（不是在某个 location 里）：

  if ($request_uri ~* "^/index\.php\?(.*)$") { set $args_1 $1; # 提取 m/c/a/id 等参数，拼成新路径；示例：m=home&c=user&a=info&id=123 → /home/user/info/123 if ($args_1 ~* "m=([^&]*)&c=([^&]*)&a=([^&]*)&id=([^&]*)") { rewrite ^/index\.php$ /$1/$2/$3/$4? permanent; } # 兜底：无法解析的参数，跳首页或 404 rewrite ^/index\.php$ /? permanent; }

• 避免用 last，必须用 permanent（等价于 301）
• 不要写 rewrite ... redirect，它发的是 302；permanent 才是 301
• 测试前清浏览器缓存，curl -I 看响应头是否含 HTTP/1.1 301 Moved Permanently

PHP 层兜底跳转：当 Nginx 无法精准解析参数时

如果旧 URL 参数结构混乱（如带空格、特殊符号、嵌套数组），Nginx 正则难匹配，就得在入口文件 index.php 开头做跳转 —— 但必须赶在任何输出之前。

立即学习“PHP免费学习笔记（深入）”；

• 在 index.php 最顶部插入：

  <?php if (isset($_SERVER['QUERY_STRING']) && strpos($_SERVER['REQUEST_URI'], 'index.php?') === 0) { parse_str($_SERVER['QUERY_STRING'], $qs); // 示例：按 m/c/a 映射到模块/控制器/操作 if (!empty($qs['m']) && !empty($qs['c']) && !empty($qs['a'])) { $newPath = '/' . $qs['m'] . '/' . $qs['c'] . '/' . $qs['a']; if (!empty($qs['id'])) $newPath .= '/' . $qs['id']; header('HTTP/1.1 301 Moved Permanently'); header('Location: ' . $newPath); exit; } } ?>

• 注意 parse_str() 不会自动 urldecode，若参数含中文或特殊字符，需先 urldecode() 再解析
• 这个逻辑仅作兜底，性能不如 Nginx 层处理，高并发下慎用
• 确保 index.php 文件开头无 BOM、无空格、无 echo，否则 header() 必报错

验证跳转是否生效的关键点

很多人配完以为 OK，其实 301 并没真正发出 —— 常见失效原因是跳转链路被中间层截断或状态码被覆盖。

• 用 curl -I http://yoursite.com/index.php?m=home&c=user&a=info 查看响应头，必须出现 HTTP/1.1 301 Moved Permanently 和 Location: 字段
• 检查 Nginx error log，若出现 rewrite or internal redirection cycle，说明 rewrite 规则形成死循环，要加条件排除目标路径
• 如果跳转后页面 404，不是跳转失败，而是新路径没被 ThinkPHP 路由识别 —— 检查 route.php 是否定义了对应规则，例如 'home/user/info/:id' => 'Home/User/info'
• HTTPS 站点要注意：Nginx 中 rewrite 的 Location 值默认用 HTTP，需显式写成 https:// 或用 $scheme 变量

最易忽略的是：Nginx 的 if 块里不能嵌套 location，也不能在 location ~ \.php 里用 if 做 querystring 判断 —— 这些都会导致 rewrite 不生效或配置加载失败。务必把跳转逻辑放在 server 块顶层，且所有 rewrite 目标路径必须与 ThinkPHP 路由规则严格对齐。