WordPress自定义菜单图片功能添加按钮div重复问题排查

核心排查方向（针对wp_post_thumbnail_only_html函数） #

• 检查函数是否被多次挂载到同一个钩子上
  常见场景为同时在admin_init、add_meta_boxes等多个钩子中调用了该函数的注册逻辑，或者同一个钩子上重复add_action/add_filter挂载了两次渲染回调，每次调用都会输出一次div结构。排查主题functions.php或者自定义插件代码中，挂载该函数的代码是否重复书写。
• 检查函数内部是否存在重复输出逻辑
  打开wp_post_thumbnail_only_html函数代码，查看是否有两次调用echo输出按钮div的逻辑，或者存在条件分支判断失效，导致if和else分支同时输出了相同结构。
• 排除WordPress内置钩子的重复触发
  部分菜单编辑页面的钩子会针对每个菜单项触发一次，如果你的函数没有做触发位置限制，会每个菜单项都输出一次按钮div。需要在函数开头增加判断逻辑，仅在目标位置输出一次，示例判断代码如下：

  // 仅在菜单编辑页面的目标位置输出，避免重复触发
  global $pagenow;
  static $has_rendered = false;
  if ($pagenow !== 'nav-menus.php' || $has_rendered) {
      return;
  }
  $has_rendered = true;
  

• 检查是否存在父子主题重复挂载的情况
  如果你在父主题和子主题中都写了该功能的挂载代码，两者会同时生效，导致函数被调用两次输出两个div。

临时修复方案 #

如果暂时找不到重复触发的根源，可以直接在渲染按钮div之前加一个静态变量标记，只要渲染过一次就不再输出，代码如下：

function wp_post_thumbnail_only_html($args) {
    // 新增去重标记
    static $button_rendered = false;
    if ($button_rendered) {
        return '';
    }
    
    // 你原来的按钮渲染逻辑
    // ...
    
    $button_rendered = true;
    return $your_button_html;
}

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