WordPress后台wp-admin-canonical URL设置错误致404问题求助

问题核心 #

你的站点部署在www.example.com/blogs子目录下，但后台的wp-admin-canonical标签生成的URL缺少/blogs路径段，再配合这段JS代码：

if ( window.history.replaceState ) {
    window.history.replaceState( null, null, document.getElementById( 'wp-admin-canonical' ).href + window.location.hash );
}

会把地址栏URL替换成不带/blogs的版本，导致点击后台链接跳转到主站404。之前修改$_SERVER['HTTP_HOST']的方法错误，因为HTTP_HOST仅用于域名，不能包含路径，这直接导致前台URL生成异常。

针对性解决方案 #

1. 修正wp-admin-canonical标签的URL

通过WordPress过滤器强制后台canonical URL包含子目录路径，把下面的代码添加到主题functions.php或自定义插件中：

add_filter('get_admin_url', 'fix_admin_canonical_subdir', 10, 3);
function fix_admin_canonical_subdir($url, $path, $blog_id) {
    if (get_current_blog_id() === $blog_id && strpos($url, '/blogs/') === false) {
        // 替换URL，确保包含/blogs子目录
        $url = str_replace('https://www.example.com/wp-admin', 'https://www.example.com/blogs/wp-admin', $url);
    }
    return $url;
}

这段代码会拦截后台URL生成逻辑，自动给canonical URL补上/blogs路径，从根源解决JS替换错误的问题。

2. 覆盖错误的JS替换逻辑

如果不想修改后台URL生成，也可以直接在后台页脚添加JS，修正replaceState的目标URL：

add_action('admin_footer', 'fix_admin_url_replace_js');
function fix_admin_url_replace_js() {
    ?>
    <script>
        document.addEventListener('DOMContentLoaded', function() {
            const canonicalLink = document.getElementById('wp-admin-canonical');
            if (canonicalLink && window.history.replaceState) {
                // 修正canonical URL中的路径
                const correctHref = canonicalLink.href.replace('https://www.example.com/wp-admin', 'https://www.example.com/blogs/wp-admin');
                window.history.replaceState(null, null, correctHref + window.location.hash);
            }
        });
    </script>
    <?php
}

这段JS会在原代码执行后（或同时）修正目标URL，确保地址栏显示正确的后台路径。

3. 直接移除wp-admin-canonical标签

如果前两种方法都不适用，可以直接禁用后台的canonical标签生成，让那段JS找不到操作对象：

add_action('wp_head', 'remove_admin_canonical_tag', 1);
function remove_admin_canonical_tag() {
    if (is_admin()) {
        remove_action('admin_head', 'wp_admin_canonical_url');
    }
}

这样地址栏就不会被JS错误修改，后台链接也能正常跳转。

注意事项 #

• 不要修改$_SERVER['HTTP_HOST']来包含路径，这违反HTTP协议规范，必然导致前台URL生成异常。
• 测试前建议先在staging环境验证代码效果，避免影响生产站点。

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