从WordPress迁移至HTML站点，高效实现海量301重定向规则的方法

针对从WordPress迁移到HTML站点的大量301重定向需求，以下是几种比千行.htaccess更高效的方案，按优先级排序：

1. Apache用RewriteMap / Nginx用map指令（性能最优） #

这是服务器层面的映射方案，比逐条RewriteRule/rewrite指令高效得多——映射文件只会在服务器启动时加载一次，请求时直接内存查询，避免了逐条规则匹配的开销。

Apache配置步骤： #

• 第一步：定义映射文件
  在服务器的httpd.conf或虚拟主机配置文件（而非.htaccess）中添加：

  RewriteMap redirects txt:/var/www/your-site/redirects.txt
  

  其中/var/www/your-site/redirects.txt是你的重定向映射文件路径，文件格式为每行一个规则，空格分隔旧URL和新URL：

  /old-blog-post/ /new-blog-post.html
  /2022/archive/ /archive-2022/
  /category/tech/ /tech-articles/
  

• 第二步：在.htaccess中添加触发规则
  只需一条规则即可处理所有映射：

  RewriteEngine On
  RewriteCond ${redirects:%REQUEST_URI|NOT_FOUND} !NOT_FOUND
  RewriteRule ^(.*)$ ${redirects:$1} [R=301,L]
  

Nginx配置步骤： #

• 第一步：定义映射
  在nginx.conf的http块中添加：

  map $request_uri $new_uri {
      include /etc/nginx/conf.d/your-site/redirects.conf;
  }
  

  映射文件redirects.conf格式为每行一个规则，分号结尾：

  /old-blog-post/ /new-blog-post.html;
  /2022/archive/ /archive-2022/;
  

• 第二步：在server块中触发重定向

  server {
      # 其他配置...
      if ($new_uri) {
          return 301 $new_uri;
      }
  }
  

注意：这个方案需要你有服务器配置权限（比如VPS、独立服务器），虚拟主机用户如果无法修改服务器配置，可参考下面的方案。

2. 服务器端脚本批量处理（无服务器配置权限时首选） #

如果无法修改服务器配置，可以用PHP/Node.js等脚本统一处理重定向，把规则存在JSON/CSV或数据库中，请求时查询映射并返回301。关键是要把映射加载到内存缓存，避免每次请求都读取文件。

PHP示例： #

• 第一步：准备重定向映射文件
  创建redirects.json，格式如下：

  {
      "/old-blog-post/": "/new-blog-post.html",
      "/2022/archive/": "/archive-2022/",
      "/category/tech/": "/tech-articles/"
  }
  

• 第二步：编写入口处理脚本
  创建index.php，作为所有请求的入口：

  <?php
  // 静态变量缓存映射，脚本生命周期内只加载一次
  static $redirects;
  if (!$redirects) {
      $redirects = json_decode(file_get_contents(__DIR__ . '/redirects.json'), true);
  }
  
  $request_uri = $_SERVER['REQUEST_URI'];
  // 精确匹配旧URL
  if (isset($redirects[$request_uri])) {
      header('HTTP/1.1 301 Moved Permanently');
      header('Location: ' . $redirects[$request_uri]);
      exit;
  }
  
  // 无重定向时，返回对应的HTML文件
  $target_file = __DIR__ . $request_uri;
  if (file_exists($target_file) && is_file($target_file)) {
      readfile($target_file);
  } else {
      header('HTTP/1.1 404 Not Found');
      readfile(__DIR__ . '/404.html');
  }
  ?>
  

• 第三步：用.htaccess把请求指向脚本

  RewriteEngine On
  # 排除真实存在的文件/目录
  RewriteCond %{REQUEST_FILENAME} !-f
  RewriteCond %{REQUEST_FILENAME} !-d
  RewriteRule ^(.*)$ index.php/$1 [L]
  

3. 合并相似规则（减少.htaccess行数） #

如果旧URL有明显规律（比如WordPress的/年/月/文章名/格式），可以用正则表达式批量匹配，把几百条规则合并成几条，大幅减少.htaccess的大小和匹配开销。

示例：

• WordPress文章URL：/2023/05/my-first-post/
• 新HTML URL：/my-first-post.html

只需一条规则即可匹配所有此类URL：

RewriteEngine On
RewriteRule ^\d{4}/\d{2}/([^/]+)/$ /$1.html [R=301,L]

再比如旧分类URL是/category/[分类名]/，新URL是/[分类名]-list/：

RewriteRule ^category/([^/]+)/$ /$1-list/ [R=301,L]

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