WordPress添加重写规则未按预期返回结果问题排查

• 确认query_vars注册逻辑
  检查tt_destination的注册代码是否完整，确保它被正确添加到可信任query变量列表中，示例代码：

  add_filter('query_vars', function($vars) {
      $vars[] = 'tt_destination';
      return $vars;
  });
  

  若过滤器优先级设置不当，可能导致二级路径下该变量未被正确传递。

• 调试重写规则匹配结果
  刷新重写规则后，添加调试代码查看请求匹配情况：

  add_action('init', function() {
      $request = $_SERVER['REQUEST_URI'];
      preg_match('#^explore-destinations\/?(.*)#', $request, $matches);
      error_log('请求URI: ' . $request);
      error_log('匹配结果: ' . print_r($matches, true));
  }, 11);
  

  访问出问题的URL后，查看服务器日志（或开启WP_DEBUG_LOG），确认$matches[1]是否正确获取到north-america。

• 排查规则冲突
  你的规则优先级为bottom，可能有其他高优先级规则先匹配了目标URL。可以打印所有重写规则查看顺序：

  add_action('init', function() {
      global $wp_rewrite;
      var_dump($wp_rewrite->rules);
  }, 100);
  

  检查是否有自定义文章类型归档、页面或插件规则提前匹配了explore-destinations/north-america/路径。

• 验证模板处理逻辑
  空白页通常是PHP致命错误被抑制导致的，开启WP_DEBUG=true查看具体报错。检查渲染页面的模板代码，确认处理tt_destination为单层级（仅continent）的逻辑是否存在漏洞，比如是否强行调用了不存在的子区域数据。

• 优化重写规则正则
  原正则可能导致匹配结果带结尾斜杠，干扰后续逻辑，可调整为精准匹配层级：

  // 匹配二级路径（continent）
  add_rewrite_rule('^explore-destinations/([^/]+)/?$','index.php?tt_destination=$matches[1]', 'bottom');
  // 匹配三级路径（continent/state）
  add_rewrite_rule('^explore-destinations/([^/]+)/([^/]+)/?$','index.php?tt_destination=$matches[1]/$matches[2]', 'bottom');
  // 匹配四级路径（continent/state/city）
  add_rewrite_rule('^explore-destinations/([^/]+)/([^/]+)/([^/]+)/?$','index.php?tt_destination=$matches[1]/$matches[2]/$matches[3]', 'bottom');
  

  分层级定义规则可避免模糊匹配引发的冲突。

• 确认永久链接设置
  确保永久链接使用自定义结构（如/%postname%/），重写规则仅对自定义永久链接生效。每次修改规则后，务必在后台「设置-永久链接」页面点击「保存更改」，强制刷新规则缓存。

内容的提问来源于stack exchange，提问作者Eric Levy