Odoo 17应用未显示在主应用下拉菜单问题求助

针对你遇到的应用安装后无GUI入口、主菜单不显示的问题，按以下步骤逐一排查：

• 检查菜单XML结构正确性
  确保<menuitem>标签配置完整，顶级菜单可关联Odoo根菜单base.menu_root，子菜单指定正确的parentID。示例：

  <!-- 顶级菜单 -->
  <menuitem name="数据推送工具" id="menu_data_push_root" parent="base.menu_root" sequence="10"/>
  <!-- 子菜单关联对应action -->
  <menuitem name="推送任务列表" id="menu_data_push_task" parent="menu_data_push_root" action="action_data_push_task" sequence="10"/>
  

• 验证Action配置有效性
  Action必须正确关联你的业务模型和视图，确保res_model对应你定义的模型，view_mode包含已创建的视图类型（如tree,form）。示例：

  <record id="action_data_push_task" model="ir.actions.act_window">
      <field name="name">推送任务</field>
      <field name="res_model">data.push.task</field>
      <field name="view_mode">tree,form</field>
  </record>
  

• 确认XML文件已被加载
  在__manifest__.py的data列表中，必须包含你的菜单XML文件路径，否则Odoo不会加载该配置：

  'data': [
      'security/ir.model.access.csv',
      'views/menu_config.xml',  # 替换为你的菜单XML文件名
      'views/data_push_views.xml',
  ],
  

• 检查模型权限配置
  缺失权限会导致菜单完全不可见，在security/ir.model.access.csv中为你的模型添加权限（至少给base.group_user配置读写权限）：

  id,name,model_id:id,group_id:id,perm_read,perm_write,perm_create,perm_unlink
  access_data_push_task,access.data.push.task,model_data_push_task,base.group_user,1,1,1,1
  

• Odoo 17特定配置注意

  • 不要随意添加app="True"，该属性用于标记应用主菜单，需配合__manifest__.py中application: True使用，错误配置会触发编译报错。若要设置为顶级应用菜单，给根菜单添加web_icon属性即可：

    <menuitem name="数据推送" id="menu_data_push_main" web_icon="your_module,static/description/icon.png" sequence="20"/>
    

  • 确保__manifest__.py中application设为True，否则不会在主应用菜单列表中显示。

• 编译与刷新操作
  修改配置后，在Odoo后台找到你的应用，点击「升级」而非重新安装；同时强制刷新浏览器页面（Ctrl+Shift+R），避免前端缓存导致菜单不加载。

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