添加add_rewrite_tag后WooCommerce我的账户页显示文章页问题求助

嘿，这个坑我之前踩过好几次，大概率是你的自定义重写标签和WooCommerce的/my-account页面规则发生了冲突，或者你定义的规则太宽泛，不小心把/my-account路径当成了文章的查询变量。下面分几种常见情况给你排查和解决：

1. 检查自定义标签的slug是否和现有页面/端点重名 #

如果你定义的标签slug是%my_account%或者类似和/my-account接近的名称，WordPress会优先匹配这个标签规则，把/my-account当成标签对应的变量值，从而错误地解析成文章查询。

解决方案：
给你的自定义标签换一个独特的、不会和现有页面/端点冲突的slug，比如：

add_rewrite_tag('%my_plugin_dashboard%', '([^/]+)');

2. 调整重写规则的精准度与优先级 #

只使用add_rewrite_tag会生成比较通用的规则，很容易和WooCommerce的页面规则抢优先级。你需要配合add_rewrite_rule来限定规则只匹配你的自定义页面路径，避免干扰/my-account。

比如你的自定义页面路径是/custom-member-page/，可以这么写：

add_action('init', function() {
    // 添加自定义标签
    add_rewrite_tag('%custom_member_param%', '([^/]+)');
    // 添加精准匹配的重写规则，只作用于你的自定义页面
    add_rewrite_rule(
        '^custom-member-page/([^/]+)/?$',
        'index.php?custom_member_param=$matches[1]&post_type=page&pagename=custom-member-page',
        'top'
    );
});

这里通过pagename明确指定匹配你的自定义页面，不会让规则误匹配到/my-account。

3. 排查查询变量是否被覆盖 #

有时候你使用的查询变量名可能和WooCommerce内置的变量冲突（比如account、user这类），导致/my-account的查询逻辑被打乱。

验证方法：
在template_redirect钩子里打印当前查询变量，看看/my-account页面被解析成了什么：

add_action('template_redirect', function() {
    if (strpos($_SERVER['REQUEST_URI'], '/my-account/') !== false) {
        var_dump($GLOBALS['wp_query']->query_vars);
        exit;
    }
});

如果输出里有你的自定义标签变量，且值是my-account，说明规则确实匹配错了，需要调整标签的匹配模式或者规则路径。

4. 别忘了刷新重写规则 #

每次修改重写规则后，一定要去WordPress后台的「设置→固定链接」页面，直接点击「保存更改」刷新规则，否则新的规则不会生效。

内容的提问来源于stack exchange，提问作者Akash Agrawal