WordPress自定义菜单点击后不显示对应链接页面如何排查？

现有实现代码 #

菜单注册代码 #

add_action( 'after_setup_theme', 'register_custom_menu' );
function register_custom_menu() {
    register_nav_menu( 'primary', __( 'Main Menu' ) );
}

前端菜单调用代码 #

<?php wp_nav_menu( array(
    'theme_location' => 'header-menu',
    'container_class' => 'header-menu',
) );
?>

异常表现 #

菜单可在后台正常创建、保存配置，前端可正常渲染菜单结构；点击菜单项后地址栏已更新为对应页面路径，但页面始终显示首页内容，全程无错误提示。

排查方向（按问题出现概率从高到低排序） #

• 重置固定链接规则：进入WordPress后台「设置-固定链接」页面，不需要修改任何配置，直接点击底部「保存更改」按钮，强制刷新站点伪静态规则。本地开发环境80%以上的地址正确但加载首页问题，都是初始化站点后未保存固定链接、伪静态规则未生效导致的。
• 排查前端JS拦截逻辑：打开浏览器F12开发者工具，切换到「源代码」面板，全局搜索preventDefault关键词，查看是否有全局脚本绑定了a标签的click事件，拦截了默认跳转行为（常见于写坏的PJAX无刷新跳转脚本、平滑滚动脚本，误拦截所有链接后没有正确执行内容替换逻辑，就会出现地址变了但页面不更新的情况）。
• 修正菜单位置参数不匹配问题：你注册菜单时声明的位置slug是primary，但前端调用时传入的theme_location参数值是header-menu，二者不匹配时WordPress会自动拉取第一个已创建的菜单作为 fallback 输出，存在隐性的链接生成异常风险。把前端调用代码里的theme_location值改为primary，再到后台「外观-菜单」的「菜单设置-显示位置」区域重新勾选绑定对应菜单，保存后测试。
• 检查Web服务器重写规则：如果用的是Nginx本地环境，确认站点配置里已经添加了WordPress官方推荐的伪静态规则，排查是否存在所有请求都重写到首页入口、但没有传递路径参数的问题；如果是Apache环境，确认站点根目录的.htaccess文件存在、有可读权限，文件内的WordPress默认重写规则没有被篡改。
• 排查主查询篡改问题：检查主题内的自定义代码，查看是否有挂载pre_get_posts钩子的逻辑，没有加is_admin()判断、也没有区分页面类型，强行修改了所有查询的条件，导致访问内页时主查询依然返回首页内容；同时检查模板文件中主循环前如果有自定义WP_Query调用，确认查询结束后是否执行了wp_reset_query()重置全局查询变量，避免主循环数据被覆盖。
• 插件/主题冲突排查：临时禁用所有已安装插件，切换到WordPress官方默认主题（如Twenty Twenty系列）测试，如果页面跳转恢复正常，再逐个启用插件、切回自定义主题，定位导致异常的插件或主题代码。

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