WordPress Rewrite API在非根RewriteBase下失效问题排查

1. 核心问题定位 #

你的情况核心原因是Bitnami部署的WordPress默认禁用了.htaccess，所有重写规则都存储在服务器配置文件/opt/bitnami/apache2/conf/vhosts/htaccess/wordpress-htaccess.conf中，WordPress的Rewrite API无法直接修改这个文件，导致你通过add_rewrite_rule添加的规则根本没生效，访问example.com/redirect/1/才会返回404。

你提到的自动添加脱字符^、QSA标记，属于Rewrite API的默认行为，但因为规则未被加载，这些都不是当前的关键问题。

2. 纯WordPress代码替代方案（无需修改服务器配置） #

既然没法依赖Rewrite API生成服务器级规则，换用WordPress内部路由+模板重定向的方案实现需求：

步骤1：注册自定义查询变量 #

在插件文件中注册redirectid，让WordPress识别这个查询参数：

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

步骤2：添加内部重写规则 #

保留重写规则，但将目标指向WordPress入口文件，让系统先接管请求：

function add_custom_redirect_rule() {
    add_rewrite_rule(
        'redirect/([0-9]+)/?$',
        'index.php?redirectid=$matches[1]',
        'top'
    );
    flush_rewrite_rules();
}
register_activation_hook(__FILE__, 'add_custom_redirect_rule');

步骤3：模板重定向到插件处理页 #

通过template_redirect钩子检测查询变量，存在则加载插件的处理页面：

function handle_custom_redirect() {
    $redirect_id = get_query_var('redirectid');
    if ($redirect_id) {
        // 验证ID格式合法性
        if (!is_numeric($redirect_id)) {
            wp_redirect(home_url('/404/'));
            exit;
        }
        // 加载插件的处理文件
        require_once WP_PLUGIN_DIR . '/myplugin/redirect/index.php';
        exit;
    }
}
add_action('template_redirect', 'handle_custom_redirect');

步骤4：强制刷新规则 #

激活插件后，若规则未生效，手动进入WordPress后台「设置→固定链接」，点击「保存更改」即可强制刷新内部路由规则。

3. 移除QSA标记的方法（针对正常支持.htaccess的环境） #

如果是普通主机环境，要去掉Rewrite API自动添加的QSA标记，可通过钩子修改生成的规则：

function remove_qsa_from_rewrite_rules($rules) {
    return str_replace('[QSA,L]', '[L]', $rules);
}
add_filter('mod_rewrite_rules', 'remove_qsa_from_rewrite_rules');

注意：该方法在Bitnami环境无效，因为规则不会写入.htaccess。

4. Bitnami环境的额外说明 #

Bitnami为了安全和性能，默认禁用.htaccess，所有重写规则需手动添加到服务器配置文件，但这需要服务器权限，不符合你「纯WordPress代码」的需求。如果长期使用WordPress，建议更换普通的LAMP/Windows IIS主机，避开Bitnami的特殊配置限制。

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