Odoo 二次开发指南:模块结构、三条定制路线与五个必踩的坑
从技术栈和最小模块骨架讲起,说明 Odoo 定制的三条路线(配置 / 继承 / 改源码)该怎么排优先级,以及 Odoo 20 带来的破坏性变更与升级成本。适合正在评估 ERP 定制方案的企业与技术负责人。
先给结论:Odoo 适合谁,不适合谁
Odoo 是一套开源 ERP,用 Python 写,一个数据库里能同时跑官网、商城、进销存、生产、财务、人事、项目管理。它真正省事的地方不是模块多,而是所有模块共享同一套模型定义、同一套权限和同一套视图机制——你在销售单上加一个字段,库存、财务、报表里能直接引用同一份数据,不用做接口对接。
三类情况不建议上 Odoo:业务流程一周一变、且内部没人能拍板规则的;只需要一个十几人用的极简表单工具的(Excel 加个共享表就够);团队里没有任何人能维护服务器、备份和版本升级的。Odoo 的运维成本主要不在开发,在升级,这一点下面会单独讲。
技术栈:三句话说完
后端 Python + ORM(不用手写 SQL 就能操作数据库),数据库 PostgreSQL(只支持这一个,不接受 MySQL),前端 OWL 框架 + QWeb 模板,报表靠 QWeb 转 PDF,依赖 wkhtmltopdf 渲染。外部系统对接走 JSON 接口。
| 项 | Odoo 19 | Odoo 20 |
|---|---|---|
| 发布时间 | 2025 年 9 月 | 2026 年 9 月 24 日 |
| Python 最低版本 | 3.10 | 3.12 |
| PostgreSQL 最低版本 | 13 | 16 |
| 外部接口 | JSON-2,旧 XML-RPC 标记弃用 | JSON-2 为唯一方向,database 服务已移除 |
| 标准支持到期 | 2028 年 9 月(计划) | 2029 年 9 月(计划) |
选版本不要只看新旧:新版本第三方模块没跟上是常态。Odoo 20 刚发布时,官方升级服务的目标版本仍只开放到 17 / 18 / 19,也就是说已经跑在 19 上的库,短期内没有官方通道升到 20。做新项目、且上线时间在半年以后的,可以直接选 20;已经开工或者近期要上线的,留在 19 更稳。
一个模块的最小骨架
Odoo 的能力全靠模块(addon)叠加,没有任何「改主题文件」式的做法。一个能装的最小模块就这几个文件:
my_inspection/ ├── __manifest__.py ├── __init__.py ├── models/ │ ├── __init__.py │ └── inspection.py ├── security/ │ └── ir.model.access.csv ├── views/ │ └── inspection_views.xml ├── data/ │ └── inspection_sequence.xml └── static/description/icon.png
__manifest__.py 是模块身份证,声明依赖、数据文件和版本号。版本号写成「Odoo 主版本.模块版本」,升级时 Odoo 靠它判断要不要执行迁移脚本:
{
'name': '设备巡检',
'version': '19.0.1.0.0',
'category': 'Operations',
'depends': ['base', 'mail'],
'data': [
'security/ir.model.access.csv',
'data/inspection_sequence.xml',
'views/inspection_views.xml',
],
'installable': True,
'application': True,
'license': 'LGPL-3',
}模型定义业务表和字段。下面这个巡检单的例子包含了一个真实模块的四个基本要素:字段、默认值、状态机、以及带业务逻辑的按钮方法:
from odoo import models, fields, api
class Inspection(models.Model):
_name = 'x.inspection'
_description = '设备巡检单'
_inherit = ['mail.thread']
name = fields.Char('单号', required=True, copy=False,
default='新建', readonly=True)
device_id = fields.Many2one('x.device', string='设备', required=True)
inspector_id = fields.Many2one('res.users', string='巡检人',
default=lambda self: self.env.user)
date = fields.Date('巡检日期', default=fields.Date.context_today)
state = fields.Selection([
('draft', '草稿'),
('done', '已完成'),
], string='状态', default='draft')
def action_done(self):
for rec in self:
rec.state = 'done'
rec.name = self.env['ir.sequence'].next_by_code('x.inspection')视图用 XML 声明表单长什么样,Odoo 会自动按权限和字段类型渲染,不需要写前端代码:
<record id="view_x_inspection_form" model="ir.ui.view">
<field name="name">x.inspection.form</field>
<field name="model">x.inspection</field>
<field name="arch" type="xml">
<form>
<header>
<button name="action_done" string="完成" type="object"
class="btn-primary"/>
</header>
<sheet>
<group>
<field name="name"/>
<field name="device_id"/>
<field name="inspector_id"/>
<field name="date"/>
</group>
</sheet>
</form>
</field>
</record>剩下两块别漏:security/ir.model.access.csv 控制哪个用户组能增删改查,没写这行权限记录的话,模块装上了管理员也打不开菜单;data/ 里放序列号规则、初始数据。这两处漏了,表现是「模块装了但看不到」,新手最容易卡在这里。
三条定制路线,优先级不能反
同样一个需求,有三种做法,成本差好几倍,长期维护差更多:
- 配置:字段、审批流、报表布局大部分能在界面里配出来,Odoo Studio 是图形化做这件事的(企业版功能)。零代码,升级不受影响。
- 继承:新建自己的模块,用
_inherit扩展标准模型,用xpath改标准视图。标准代码一行不动,升级时只需检查继承点是否还在。九成定制需求应该走这一条。 - 改源码:直接改 Odoo 自带的 addon 文件。改起来最快,后果是下次升级要么整体重做,要么永远停在老版本。除了临时排查问题,没有正当理由这么做。
判断标准很简单:问一句「这段改动能不能单独打包成一个模块,删掉它系统还能正常跑」。能,就是继承;不能,你就是在改源码。
版本升级才是真正的成本大头
Odoo 每年 9 月发一个大版本,标准支持三年。三年一到,安全更新停止,这时候不升也得升。而升级的难点从来不是数据,是自定义模块——官方文档写得很清楚:数据库里只要装了自定义模块,就必须等这个模块有对应目标版本,才能升级。
Odoo 20 这次改动偏框架层,自定义代码受影响的概率不低:
- 运行环境下限提高:Python 3.12、PostgreSQL 16 成为最低要求,老服务器的系统 Python 版本跟不上,就得先升级操作系统。
- 接口层换血:旧的 XML-RPC / JSON-RPC 接口标记弃用,database 服务已经移除,所有外部对接(WMS、POS 硬件、第三方平台)要改走 JSON-2。
- 权限模型简化:记录规则(record rules)被移除,改成直接在访问权限上设 domain。凡是自定义过安全规则的模块,全部要重写。
- 邮件追踪机制变更:追踪字段的存储方式改了,依赖它的阶段停留时长、燃尽图类功能要跟着调整。
能做的准备只有一件:定制代码全部收在自己的模块里,一行都别散落在标准模块中。这样升级时工作量是可数的(一个模块一个模块移植 + 回归测试),而不是整站重做。
部署时最容易忽略的四件事
- 备份要含数据库和附件目录。只备份 PostgreSQL 会丢掉存在文件系统里的附件,恢复后单据还在、附件全变空白。
- worker 数量要按 CPU 核数配。默认配置下并发一高就整站转圈,不是代码慢,是进程不够。
- 中文本地化要装对:会计科目表、发票格式、税制都跟地区包绑定,装错了后面迁移数据非常麻烦。
- PDF 报表依赖 wkhtmltopdf。版本不对会出现中文乱码或者报表空白,服务器上的字体也要单独装。
自研、外包还是买 SaaS
| 路线 | 适合 | 代价 |
|---|---|---|
| 买 Odoo 官方 SaaS / Odoo.sh | 流程标准、不想管服务器 | 按用户数订阅,定制受平台限制 |
| 自建 + 标准模块配置 | 有 IT 人员,需求在标准功能范围内 | 省订阅费,但要自己运维和升级 |
| 自建 + 定制开发 | 有行业特殊流程,市面产品覆盖不了 | 一次开发费 + 每个大版本的移植费 |
定制开发的报价方式通常是按人天评估,工作量集中在四块:数据模型设计、界面与流程、权限、报表。一个含模型 / 视图 / 权限 / 打印模板的中等模块,经验值在 5-15 人天;涉及外部系统对接、历史数据迁移的,人天会翻倍。报「一个模块多少钱」而不问字段和流程的,基本都会在后面加钱。
五个最常见的坑
- 拿 Odoo 当万能框:指望它开箱即用覆盖全部业务。实际情况是行业特殊流程一定要定制,先做流程梳理再谈开发量。
- 上线前不做数据迁移演练:老系统几十万条记录,第一次导就发现字段对不上、编码重复。迁移要单独排期,别压在验收前一天。
- 权限最后才配:开发阶段都用管理员账号,上线当天才发现销售能看到成本价。权限设计要和模型设计同步做。
- 定制代码散落在标准模块里:当时省了半天,升级时多花两个月。
- 没有版本规划:一开始随便挑个版本,两年后发现已经停止支持,而自定义模块没人接手移植。
如果这三件事在项目启动时就说清楚——业务边界、定制代码的归属与打包方式、以及未来三年打算跟着哪个版本走——Odoo 项目的成功率会高很多。它是一套很耐用的系统,前提是别用一次性项目的方式去做它。
微信号:wx1566768