Odoo15新增自定义模块后找不到estate模块的问题排查求助

1. 检查模块目录结构与文件命名 #

• 确认自定义插件目录/Users/xuhongxin/src/custom下直接放置estate模块文件夹，有效路径为/Users/xuhongxin/src/custom/estate/__manifest__.py，禁止多层嵌套
• estate目录下必须存在__init__.py文件，可为空文件，否则Odoo不会识别为有效模块
• 确认模块配置文件名为__manifest__.py，前后均为双下划线，你当前使用的manifest.py命名错误，这是最常见的核心错误

2. 修正manifest配置内容 #

你当前的配置是直接复制的CRM模块内容，和你开发的estate模块不匹配，需修改：

• 删除data、demo、css字段中所有未实际创建的文件路径，刚开发的新模块不存在这些资源，填写不存在的路径会导致模块识别失败
• depends字段初期仅保留'base'即可，多余的未安装依赖也会导致模块不显示
• 确认installable字段值为True，你当前配置符合要求

3. 校验启动命令配置 #

• 确认--addons-path参数用英文逗号分隔，无多余空格，推荐使用绝对路径避免识别错误，示例命令：
  ./odoo-bin --addons-path=/Users/xuhongxin/src/custom,/你的Odoo源码绝对路径/addons
• 启动后查看终端日志，确认无estate模块相关的加载报错，如有报错先按日志提示修正

4. 后台操作排查 #

服务启动成功后进入Odoo后台操作：

• 开启调试模式，进入「应用」菜单
• 点击顶部的「更新应用列表」按钮，等待更新完成
• 清空搜索框默认筛选条件，取消「应用」筛选后直接搜索estate即可找到模块

5. 权限校验 #

• 确认Mac当前用户对/Users/xuhongxin/src/custom目录及子文件有可读权限，可执行以下命令统一赋予权限：
  chmod -R 755 /Users/xuhongxin/src/custom

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