新模块已经显示为 enabled，setup:upgrade 也没有报错，但后台左侧完全看不到菜单。很多人会直接修改 acl.xml，反复清缓存后仍然没有结果，因为菜单是否出现至少经过模块加载、XML 合并、父节点定位、ACL 授权四道判断。

确认代码真的属于当前运行版本

bin/magento module:status Vendor_Module
bin/magento setup:di:compile
bin/magento cache:clean config

生产模式下编译失败不能用旧 generated 目录掩盖。先确认 app/code/Vendor/Module/etc/adminhtml/menu.xml 的大小写、目录层级和模块名完全一致，再查看 app/etc/config.php 是否启用。部署机器若使用只读发布包，还要确认文件确实进入当前 release。

menu.xml 的父节点是否存在

最小菜单项通常包含唯一 id、title、module、sortOrder、parent、action 与 resource。若 parent 指向一个未安装扩展的节点，子项也会消失。临时把 parent 改到确认存在的核心节点，只适合定位，最终仍应根据产品信息架构选择正确位置。

<add id="Vendor_Module::report"
     title="Sales Audit"
     module="Vendor_Module"
     sortOrder="80"
     parent="Magento_Sales::sales"
     action="vendor/report/index"
     resource="Vendor_Module::report" />

resource 必须能在合并后的 ACL 树中找到。它不要求与菜单 id 相同，但保持一致更容易维护。父资源层级错误、重复 id 被另一个模块覆盖、XML schema 无效，都会让结果与预期不同。

角色权限有缓存，也有范围

用全权限管理员能看到、普通管理员看不到，才优先检查角色授权。进入 System → Permissions → User Roles，重新保存角色后退出再登录。不要仅用同一个已打开多小时的后台会话判断权限是否生效。

如果所有管理员都看不到，检查 var/log/system.log 和部署时的 XML 验证输出。还可用 bin/magento dev:urn-catalog:generate 配合 IDE 校验配置文件。某些扩展通过配置关闭自身输出或动态移除菜单，因此也要搜索 menu 事件、plugin 和 backend model。

别把能访问路由当作菜单正常

直接输入后台 action URL 能打开，只证明 controller 与 ACL 可能允许访问，不证明菜单节点成功合并。反过来，菜单出现但点击 404，则要查 routes.xml、controller 路径和 admin frontName。把“菜单生成”和“路由分发”分开验证，通常十几分钟就能确定问题在哪一层。