参考来源与致谢
- 引用来源:How can I install apps/modules in odoo v9
- 原作者:原页面署名作者或发布机构(剪藏记录未保存可核验的个人署名)
- 感谢词:感谢原作者及发布机构对技术知识的公开分享。本文已结合企业运维场景完成脱敏、核验与原创重写,并非原文转载;如权利人需要更正署名或来源信息,请联系本站。
适用场景 #
需要在 Odoo 9 环境中安装官方应用、第三方模块或自研模块时,通常有两种做法:把模块放入默认插件目录,或建立独立的自定义插件目录并在配置中登记。后者便于升级与备份,推荐生产环境采用。本文描述通用操作路径,具体路径、服务名与配置文件名以实际部署为准,不确定处请查阅对应版本官方文档。
准备与风险 #
- 确认 Odoo 版本与模块声明的兼容版本一致,版本不匹配可能导致加载失败。
- 准备测试环境,先在测试库验证模块安装与升级,再操作生产库。
- 备份数据库与文件存储,并记录当前配置文件的完整内容。
- 确认模块来源可信,第三方模块可能包含任意代码,安装即等于在该服务账号权限下执行。
- 确认磁盘空间、文件属主与权限,服务账号需对插件目录有读取权限。
涉及重启服务、修改配置、安装模块等操作前,务必完成数据库备份并保留可回退的配置副本。生产环境操作建议安排在维护窗口。
处理步骤 #
1. 建立自定义插件目录 #
在 Odoo 安装目录旁建立独立目录,与默认插件目录并列,例如:
[Odoo安装目录]/addons
[Odoo安装目录]/custom_addons
将模块解压或放置到 custom_addons 下,每个模块一个子目录,目录名与模块技术名一致。
2. 登记插件路径 #
编辑服务配置文件,在 addons_path 中追加新目录,多个路径用英文逗号分隔,顺序影响同名模块的加载优先级:
addons_path = [Odoo安装目录]/custom_addons,[Odoo安装目录]/addons
保存后重启 Odoo 服务,使配置生效。
3. 更新模块列表 #
以具备权限的账号登录,进入应用或模块管理界面,执行“更新模块列表”。该操作会重新扫描插件路径并刷新可用模块清单。
4. 安装模块 #
在模块列表中按技术名或显示名搜索目标模块,确认作者、版本与依赖后点击安装。安装过程会创建或修改数据库结构,耗时取决于模块规模。
5. 启用开发者相关选项 #
部分界面与调试功能需要开发者模式或技术特性权限。可在“关于”页面启用开发者模式,或在用户设置中为用户开启技术特性,然后刷新页面。该步骤仅影响界面可见性,不改变模块本身。
验证方法 #
- 模块列表中目标模块状态显示为已安装,且无报错提示。
- 查看服务日志,确认无导入错误、依赖缺失或权限异常。
- 打开模块提供的菜单或视图,执行一次基本业务操作,确认功能可用。
- 重启服务后再次确认模块仍正常加载,排除仅内存生效的情况。
回退建议 #
- 卸载模块前先备份数据库,卸载可能删除该模块创建的数据表与字段。
- 若仅配置有误,恢复原配置文件并重启服务即可。
- 若模块导致服务无法启动,可临时从
addons_path移除该目录或移走模块目录,再重启排查。 - 数据库层面回退应使用备份恢复,不建议手工删改表结构。
常见问题 #
- 模块列表搜不到:检查目录名与模块技术名是否一致、
addons_path是否生效、服务是否已重启。 - 安装报依赖错误:确认依赖模块已安装且版本匹配。
- 升级后模块失效:核对模块声明的兼容版本,必要时联系模块提供方确认。
- 权限报错:检查插件目录属主与权限,确保服务账号可读。
