Odoo 16.0通过FTP上传的外部模块无法识别如何解决？

1. 核对模块文件完整性 #

• 确认FTP传输模式：必须用二进制模式传输，ASCII模式会损坏.py、.xml等文件，若之前用了错误模式，重新用二进制模式传输整个模块文件夹。
• 检查必备文件：模块必须包含__init__.py和__manifest__.py（旧版本为__openerp__.py）。打开__manifest__.py，确保name、version、depends等必填字段填写正确，无语法错误。

2. 修正文件权限 #

• 确保模块文件夹及文件的权限匹配Odoo运行用户（通常为odoo），执行以下命令：

  chown -R odoo:odoo /path/to/odoo/addons/your_module
  chmod -R 755 /path/to/odoo/addons/your_module
  

FTP传输后权限可能归属FTP用户，必须调整为Odoo可读写的权限。

3. 更新模块列表 #

• 后台操作：登录Odoo后台，进入应用模块，开启开发者模式（设置→激活开发者模式）后，点击右上角的更新应用列表按钮。
• 命令行操作：重启Odoo服务后执行：

  odoo-bin -d your_database_name -u base --stop-after-init
  

4. 确认模块路径配置 #

• 打开Odoo配置文件（odoo.conf），检查addons_path是否包含存放模块的文件夹路径，示例：

  addons_path = /usr/lib/python3/dist-packages/odoo/addons,/path/to/your/custom/addons
  

修改配置后必须重启Odoo服务生效。

5. 排查依赖与兼容性 #

• 检查__manifest__.py中的depends字段，确认依赖的模块已安装，且模块版本与当前Odoo版本兼容（如Odoo 16模块无法直接在Odoo 14运行）。
• 查看Odoo日志：日志路径通常为/var/log/odoo/或配置文件指定的logfile路径，搜索模块名称，定位是否存在语法错误、依赖缺失等报错信息。

6. 重启Odoo服务 #

完成上述任意调整后，重启Odoo服务使配置生效：

systemctl restart odoo

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