Odoo 二次开发指南:模块结构、三条定制路线与五个必踩的坑

从技术栈和最小模块骨架讲起,说明 Odoo 定制的三条路线(配置 / 继承 / 改源码)该怎么排优先级,以及 Odoo 20 带来的破坏性变更与升级成本。适合正在评估 ERP 定制方案的企业与技术负责人。

先给结论:Odoo 适合谁,不适合谁

Odoo 是一套开源 ERP,用 Python 写,一个数据库里能同时跑官网、商城、进销存、生产、财务、人事、项目管理。它真正省事的地方不是模块多,而是所有模块共享同一套模型定义、同一套权限和同一套视图机制——你在销售单上加一个字段,库存、财务、报表里能直接引用同一份数据,不用做接口对接。

三类情况不建议上 Odoo:业务流程一周一变、且内部没人能拍板规则的;只需要一个十几人用的极简表单工具的(Excel 加个共享表就够);团队里没有任何人能维护服务器、备份和版本升级的。Odoo 的运维成本主要不在开发,在升级,这一点下面会单独讲。

技术栈:三句话说完

后端 Python + ORM(不用手写 SQL 就能操作数据库),数据库 PostgreSQL(只支持这一个,不接受 MySQL),前端 OWL 框架 + QWeb 模板,报表靠 QWeb 转 PDF,依赖 wkhtmltopdf 渲染。外部系统对接走 JSON 接口。

项Odoo 19Odoo 20
发布时间2025 年 9 月2026 年 9 月 24 日
Python 最低版本3.103.12
PostgreSQL 最低版本1316
外部接口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/ 里放序列号规则、初始数据。这两处漏了,表现是「模块装了但看不到」,新手最容易卡在这里。

三条定制路线,优先级不能反

同样一个需求,有三种做法,成本差好几倍,长期维护差更多:

  1. 配置:字段、审批流、报表布局大部分能在界面里配出来,Odoo Studio 是图形化做这件事的(企业版功能)。零代码,升级不受影响。
  2. 继承:新建自己的模块,用 _inherit 扩展标准模型,用 xpath 改标准视图。标准代码一行不动,升级时只需检查继承点是否还在。九成定制需求应该走这一条。
  3. 改源码:直接改 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 人天;涉及外部系统对接、历史数据迁移的,人天会翻倍。报「一个模块多少钱」而不问字段和流程的,基本都会在后面加钱。

五个最常见的坑

  1. 拿 Odoo 当万能框:指望它开箱即用覆盖全部业务。实际情况是行业特殊流程一定要定制,先做流程梳理再谈开发量。
  2. 上线前不做数据迁移演练:老系统几十万条记录,第一次导就发现字段对不上、编码重复。迁移要单独排期,别压在验收前一天。
  3. 权限最后才配:开发阶段都用管理员账号,上线当天才发现销售能看到成本价。权限设计要和模型设计同步做。
  4. 定制代码散落在标准模块里:当时省了半天,升级时多花两个月。
  5. 没有版本规划:一开始随便挑个版本,两年后发现已经停止支持,而自定义模块没人接手移植。

如果这三件事在项目启动时就说清楚——业务边界、定制代码的归属与打包方式、以及未来三年打算跟着哪个版本走——Odoo 项目的成功率会高很多。它是一套很耐用的系统,前提是别用一次性项目的方式去做它。

常见问题

Odoo 社区版和企业版差在哪?
社区版开源免费(LGPL-3),核心的销售、库存、生产、项目、CMS、电商都在。企业版是付费订阅,多了完整会计、Studio 可视化定制、移动端、部分行业包和官方支持。只做进销存和简单流程,社区版够用;要用完整财务或者大量图形化配置,才需要企业版。
Odoo 二次开发一般怎么报价?
按人天评估,工作量来自四块:数据模型、界面与流程、权限、报表。一个中等复杂度的自定义模块通常 5-15 人天,含外部系统对接或历史数据迁移的会更高。报价前必须先把字段清单和流程节点定下来,否则后面一定加钱。
Odoo 能和现有的 ERP、财务软件对接吗?
能,通过 JSON 接口(Odoo 19 起主推 JSON-2,旧的 XML-RPC 已标记弃用)。对接的难点不在接口本身,而在两边的数据口径——物料编码、客户主数据、金额精度这三样对不齐,接口通了数据也是错的。
自己装 Odoo 要注意什么?
三件事:数据库只支持 PostgreSQL,MySQL 装不了;服务器要留够内存,Odoo 进程吃内存比想象中多;备份必须同时包含数据库和附件目录,只备数据库会丢附件。另外 PDF 报表依赖 wkhtmltopdf,中文要单独装字体,否则打印出来是方块。
Odoo 20 现在能直接上生产吗?
看上线时间。官方升级服务目前开放的目标版本是 17 / 18 / 19,老库还没法升到 20;新项目如果上线时间在 2027 年上半年之后,可以直接从 20 起步。第三方模块和自定义代码移植需要时间,发布当年就上生产风险偏高。

说说你的需求,30 分钟内给方案

把你想做的项目简单描述一下(做什么用、有哪些功能、什么时候要),我先给你一份功能清单与参考报价,不合适也直说。

微信二维码 · 扫码添加好友 微信号:wx1566768 电话:153-1441-3839
邮箱:313497339@qq.com