WordPress插件开发：根据Cookie状态修改URL时重定向过多问题求解

你遇到的err_too_many_redirects错误，核心原因是代码陷入了无限重定向循环：每次页面加载都会读取Cookie并跳转到带查询参数的URL，但跳转后的页面又会重复执行相同的重定向逻辑，没有设置终止条件。

解决思路 #

• 先检查当前URL是否已经包含与Cookie匹配的目标查询参数，若已存在则跳过重定向
• 保留原URL中的其他查询参数，避免覆盖用户可能携带的其他参数
• 使用**临时重定向（302）**而非永久重定向（301），因为Cookie状态是用户动态触发的临时状态
• 遵循WordPress规范，通过官方钩子执行重定向逻辑

修改后的代码示例 #

add_action('template_redirect', 'gender_filter_redirect');

function gender_filter_redirect() {
    // 若Cookie不存在，直接返回
    if (!isset($_COOKIE['gender'])) {
        return;
    }

    $current_gender = sanitize_text_field($_COOKIE['gender']);
    // 定义需要匹配的查询参数
    $target_args = [
        'filter_gender' => $current_gender,
        'query_type_gender' => 'or'
    ];

    // 检查当前URL是否已包含正确的参数
    $has_matching_args = true;
    foreach ($target_args as $key => $value) {
        if (!isset($_GET[$key]) || $_GET[$key] !== $value) {
            $has_matching_args = false;
            break;
        }
    }

    // 参数已匹配，终止重定向逻辑
    if ($has_matching_args) {
        return;
    }

    // 构建新URL：保留原有参数，替换/追加目标参数
    $new_url = add_query_arg($target_args, get_permalink());

    // 执行临时重定向并终止代码
    wp_redirect($new_url, 302);
    exit;
}

关键说明 #

• 使用template_redirect钩子：这是WordPress中执行重定向的标准时机，确保在页面内容输出前触发
• add_query_arg函数：WordPress内置的安全函数，自动处理URL编码和参数拼接，避免手动拼接的错误与安全风险
• 终止条件判断：通过对比当前查询参数与Cookie值，彻底避免无限循环
• wp_redirect替代原生header：更适配WordPress生态，自动处理兼容性问题
• exit语句：重定向后必须终止代码执行，防止后续内容输出导致headers already sent错误

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