WordPress登录表单重定向出现Header修改错误，求解决方案

看起来你遇到的是WordPress里非常常见的头部已发送错误，我来帮你拆解问题和解决办法：

错误原因分析 #

这个警告的核心逻辑很简单：HTTP协议要求所有的响应头部（比如跳转指令）必须在任何页面内容（HTML、CSS链接、甚至空白字符）之前发送。而错误提示里明确指出，输出是从wp-includes/class.wp-styles.php:287开始的——这说明WordPress已经开始输出页面的样式链接了，这时候你再调用wp_redirect()就太晚了，因为头部已经没法修改了。

看你的代码，应该是把这段跳转逻辑放在了页面渲染的阶段（比如短代码内部、页面模板的内容区域），这时候WordPress已经开始输出页面内容了，自然会触发这个错误。

解决方案 #

1. 把跳转代码移到更早的钩子执行

WordPress提供了template_redirect钩子，这个钩子会在WordPress确定好要加载的模板之后、任何页面内容输出之前触发，刚好适合放跳转逻辑。把你的代码改成这样：

add_action('template_redirect', 'custom_login_page_redirect');
function custom_login_page_redirect() {
    // 只在你的登录页面执行这个逻辑，替换成你实际的登录页面slug
    if (!is_page('login-page')) {
        return;
    }

    // 已登录用户跳转到首页
    if (is_user_logged_in()) {
        wp_redirect(get_option('home'));
        exit;
    }

    // 处理登录失败的跳转，先确保$referrer安全
    $referrer = isset($_GET['referrer']) ? esc_url_raw($_GET['referrer']) : '';
    
    // 验证来源合法，避免跳转到后台或登录页
    if (!empty($referrer) && !strstr($referrer, 'wp-login') && !strstr($referrer, 'wp-admin')) {
        wp_redirect($referrer . '/?login=failed');
        exit;
    }
}

这里要注意替换'login-page'为你实际创建的登录页面的slug，这样只会在这个页面触发跳转逻辑，不会影响其他页面。

2. 额外检查：避免意外输出

另外可以检查一下你的插件文件或自定义代码文件，确保：

• 文件开头的<?php标签前没有任何空白字符、换行或UTF-8 BOM
• 文件结尾可以去掉?>标签（PHP会自动识别文件结束，避免结尾的空白被输出）

虽然从错误提示看这不是主要原因，但这是这类错误的常见诱因，检查一下没坏处。

3. 安全提醒：处理$referrer的风险

直接使用用户提供的referrer可能存在开放重定向漏洞，建议加上域名验证，比如只允许跳转到你指定的域名：

// 允许跳转的域名列表
$allowed_domains = array('your-site.com', 'trusted-domain.com');
$parsed_referrer = parse_url($referrer);

if (!empty($referrer) && in_array($parsed_referrer['host'], $allowed_domains) && !strstr($referrer, 'wp-login') && !strstr($referrer, 'wp-admin')) {
    wp_redirect($referrer . '/?login=failed');
    exit;
}

这样能防止恶意用户通过构造referrer参数跳转到钓鱼网站。

总结 #

问题的核心就是你的跳转代码执行时机太晚，赶在页面内容输出之后了，移到template_redirect钩子就能完美解决这个问题。

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