add_menu_page 的 position 改成 5 菜单仍排在设置后面

add_action('admin_menu', function () {
    add_menu_page('图书管理', '图书管理', 'manage_options', 'book-manager', 'render_book_page', 'dashicons-book', 5.9);
}, 99);

把插件菜单的 position 从 80 改成 5，刷新后台，菜单还是排在“设置”下面，位置参数像没写，换一个管理员账号看结果一样。先别急着动参数，把报错原文和时间点记下来，顺序反了容易白折腾。

原因不复杂，position 5 已经被另一个插件占用，整数冲突时 WordPress 会按注册顺序往后追加。另有插件在 admin_menu 之后用 global $menu 重排，把顺序又改了回去。

「add_menu_page position 无效」排查到最后往往是很小的一处差异，前面那些复杂猜测可以先放一放。备份不是备了就行，恢复一次才算数，很多备份文件打开才发现是空的。

接口问题先分清是没发出去、发出去了没收到，还是收到了处理失败。偶发问题先统计频率，一小时几次和一天一次，查法完全不同。

改完顺手把文档补一句，省得下次自己重新推一遍。

处理上按这个顺序：打印 global $menu 看每个菜单实际占用的键位；换一个没被占用的浮点 position；把 admin_menu 的优先级调到 99 避开重排。

改完只确认一件事：菜单停在“文章”下方，刷新页面和切换账号位置都不变。