旧版论坛URL需301重定向至新版RESTful路径，精准匹配/viewthread.php并透传tid、page、pid等参数，避免污染query string，使用location精确或前缀匹配提升性能与安全性。
旧版论坛帖子链接（如 /viewthread.php?tid=12345&page=2）迁移到新版 RESTful 路径（如 /posts/12345?page=2），关键不是“写得越多越好”，而是精准捕获参数、保留分页逻辑、避免循环，并让搜索引擎顺利识别为 301 迁移。
先理清映射关系，再动配置
别直接写 rewrite。先列清楚几类典型旧帖 URL 和对应的新路径：
-
主帖页：
/viewthread.php?tid=12345→/posts/12345 -
带分页的帖：
/viewthread.php?tid=12345&page=3→/posts/12345?page=3 -
带高亮锚点的：
/viewthread.php?tid=12345&page=1&pid=67890#pid67890→/posts/12345?page=1#pid67890（锚点需前端兼容）
注意：新版路径不带 .php，且 tid 是唯一标识，page 和 pid 是可选查询参数，要原样透传或有选择地保留。
用 location + rewrite 精准匹配，不干扰其他请求
把规则放在 server 块里，但优先用 location 锁定范围，提升性能和可读性：
location = /viewthread.php {
if ($arg_tid ~ ^\d+$) {
rewrite ^/viewthread\.php$ /posts/$arg_tid? permanent;
}
}
说明：
-
location = /viewthread.php是精确匹配，只作用于这个入口，不影响其他.php文件 -
$arg_tid直接取查询参数值，比正则捕获更简洁安全 - 末尾的
?表示清空原始 query string，防止拼出/posts/12345?tid=12345&page=2这种错误地址 - 如果需要保留
page和pid，改用：rewrite ^/viewthread\.php$ /posts/$arg_tid?$args permanent;（Nginx 会自动追加$args）
处理带目录前缀的旧链接（如 /bbs/viewthread.php）
如果旧站部署在子目录（比如 /bbs/），不能只靠 location =，要用前缀匹配 + 正则：
location ^~ /bbs/viewthread.php {
if ($arg_tid ~ ^\d+$) {
rewrite ^/bbs/viewthread\.php$ /posts/$arg_tid?$args permanent;
}
}
注意：
-
^~表示前缀匹配且优先于正则 location，适合这类固定路径迁移 - 不要把 rewrite 写在
location /bbs/ { ... }里——太泛，可能误伤静态资源或 API - 确保新路径
/posts/...有对应的location /posts/块来正确代理或转发到后端服务
兜底与防错要点
上线前必须检查这三件事：
- 用
curl -I https://example.com/viewthread.php?tid=12345确认返回301 Moved Permanently和正确的Location: /posts/12345 - 测试带多个参数的链接，确认
$args是否完整传递，或是否意外带入了不需要的参数（如from=email可能需过滤） - 查 Nginx access 日志，筛选出仍返回 404 的旧帖路径（例如 tid 格式异常、含特殊字符），及时补规则或交由后端 fallback 处理
不复杂但容易忽略。
