BuddyPress搭配WooCommerce高流量随机404 重写规则修复

站点高流量时段出现的随机404，核心是BuddyPress（以下简称BP）注册的重写规则优先级不合理：高并发下重写规则缓存读写出现顺序错乱时，BP的通用匹配规则([^/]+)(?:/([0-9]+))?/?$会排在WordPress原生文章/分页、WooCommerce、Dokan的对应规则(.?.+?)(?:/([0-9]+))?/?$前面，把不属于BP的页面请求错误拦截到BP路由，最终触发404。
之前修改核心文件出致命错误有两个原因：一是直接修改wp-includes/class-wp.php这类WordPress核心文件本身就不符合开发规范，版本升级会直接覆盖修改，也容易引发语法错误；二是之前尝试的代码存在语法问题，数组键没有加单引号，直接触发PHP语法错误。

1. 重写规则顺序异常的标准修复方法 #

不要修改任何WordPress核心文件，把下面代码添加到当前主题/子主题的functions.php文件，或者自定义功能插件中即可：

/**
 * 修正BP重写规则优先级，解决随机404问题
 */
add_filter('rewrite_rules_array', function($rules) {
    $conflict_bp_rule = '([^/]+)(?:/([0-9]+))?/?$';
    $native_page_rule = '(.?.+?)(?:/([0-9]+))?/?$';

    if (isset($rules[$conflict_bp_rule]) && isset($rules[$native_page_rule])) {
        // 临时取出冲突的BP规则
        $bp_rule_val = $rules[$conflict_bp_rule];
        unset($rules[$conflict_bp_rule]);
        // 找到原生分页规则的位置，把BP规则插到它后面，保证原生规则优先匹配
        $native_rule_pos = array_search($native_page_rule, array_keys($rules));
        $rules = array_slice($rules, 0, $native_rule_pos + 1, true)
            + [$conflict_bp_rule => $bp_rule_val]
            + array_slice($rules, $native_rule_pos + 1, null, true);
    }
    return $rules;
}, 999); // 最高优先级执行，确保规则顺序最终生效

代码添加完成后，进入后台「设置-固定链接」页面，直接点击底部「保存更改」按钮（不需要修改任何配置），手动刷新一次重写规则即可生效。注意不要在代码里高频调用flush_rewrite_rules()，高流量下频繁刷新规则反而会加剧规则错乱问题。

2. 非BP页面移除BP重写规则的实现方法 #

可以实现，但必须加判断逻辑，不能全局移除BP规则，否则BP自身页面会直接404，对应代码同样放在functions.php中即可：

/**
 * 非BP页面自动移除BP重写规则
 */
add_filter('rewrite_rules_array', function($rules) {
    // 当前请求属于BP页面时，保留所有BP规则
    if (function_exists('is_buddypress') && is_buddypress()) {
        return $rules;
    }
    // 非BP页面过滤掉所有BP注册的路由规则
    $bp_slugs = [];
    if (function_exists('buddypress')) {
        $bp_slugs = [
            buddypress()->members->slug,
            buddypress()->activity->slug,
            buddypress()->groups->slug,
            buddypress()->blogs->slug,
            buddypress()->register->slug,
            buddypress()->activate->slug
        ];
    }
    foreach ($rules as $pattern => $query) {
        // 匹配BP专属规则
        if (strpos($query, 'bp_') === 0) {
            unset($rules[$pattern]);
            continue;
        }
        // 匹配BP各组件slug的规则
        foreach ($bp_slugs as $slug) {
            if (strpos($pattern, $slug) !== false) {
                unset($rules[$pattern]);
                break;
            }
        }
    }
    return $rules;
}, 1000);

注意：如果站点安装了其他依赖BP路由的插件，需要对应调整过滤逻辑，避免误删必要规则。

3. WordPress核心重写规则竞态问题修复落地 #

提到的核心修复指向的是WordPress重写规则缓存的并发读写竞态漏洞：高流量下多个请求同时触发重写规则刷新时，会出现规则写入不全、顺序错乱的问题，这是随机404的底层诱因之一。
如果站点WordPress版本在6.0及以上，官方已经在核心中加入了重写规则写入文件锁，这个竞态问题已经被官方修复，不需要额外加代码。如果暂时无法升级核心版本，可以添加下面的临时代码规避竞态：

/**
 * 低版本WP临时修复重写规则并发刷新竞态
 */
add_action('flush_rewrite_rules', function() {
    $lock_key = 'rewrite_flush_lock_' . get_current_blog_id();
    // 10秒锁周期内不重复刷新规则
    if (get_transient($lock_key)) {
        return false;
    }
    set_transient($lock_key, 1, 10);
}, 1);

• 禁止直接修改WordPress核心目录下的任何文件，版本升级会覆盖所有修改，且极易引发语法错误导致站点崩溃
• 排查所有已安装插件、主题的代码，确保没有在template_redirect、init这类高频触发的钩子中调用flush_rewrite_rules()，不合理的刷新调用是重写规则错乱的最常见诱因
• 所有代码添加完成、保存固定链接后，清空站点缓存、PHP OPcache缓存，避免旧的规则缓存持续生效

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