2026 年 11 月 5 日,瑞士软件质量团队 Wavect 的 Kevin Riedl 发布了一份 Odoo 20 权限迁移验收说明。整篇文档里最短、也最该被记住的一句话是这个:用户和记录都没有变,一次简单粗暴的权限改写,却把「拒绝」变成了「允许」。业务政策没有改,改变的是授权组合的方式。
这句话出现在一个微妙的时间点。Odoo 20 于 2026 年 9 月正式发布,大量企业正在做 19 到 20 的测试升级,升级平台据官方口径预计 11 月底开放。而权限这一关,恰恰最容易被「安装成功」「管理员能打开页面」这两件事糊过去——因为权限出问题的时候,界面通常一切正常。
一、两套机制合成一套,判定式变了
Odoo 19 的安全模型是两段式:先由模型级 ACL 决定「这个身份能不能对这个模型做这个操作」,再套记录规则把这些操作过滤到具体的行。这两层是叠加关系,第二层负责收窄。
Odoo 20 把操作和记录域放进了同一个访问模型。按官方 20.0 安全参考,ir.access 以组、操作和域来定义权限:带组的条目授予访问,无组的条目限制访问。这意味着过去「宽 ACL 兜底、窄规则收口」的分工不再成立——判定变成一条同时成立的式子:
至少命中一个组授权,并且满足每一项适用的全局限制。
单独的限制不会授予访问;而多出来的一个组授权,会直接扩大可读记录的范围。
| 版本 | 安全模型怎么搭 | 判定方式 |
|---|---|---|
| Odoo 19.0 | 模型级 ACL 负责授权,记录规则逐行过滤,两层叠加 | 先粗后细,第二层负责收窄 |
| Odoo 20.0 | 组、操作、域统一定义在 ir.access | 授权取并集,限制取合取 |
这个差别在代码评审里几乎看不出来。旧文件改个名、字段换个位置、能加载、能安装,看起来就「迁完了」。但政策的含义已经变了:过去被第二层挡住的那片记录,现在可能因为第一层多了一个组而露出来。而这正是最典型的静默扩权——没有报错,没有告警,只有某个本来不该看到别家数据的人,某天在搜索框里多看到几行。
二、三个公司上下文,混一个就解释不清
权限问题在多公司架构里会立刻复杂一个量级,因为「公司」在 Odoo 里有三个不同含义,而验收报告里经常只写一个「多公司正常」。
| 上下文 | 系统里对应什么 | 它回答的问题 |
|---|---|---|
| 获授权的成员资格 | 用户被加入哪些公司 | 这个身份有资格选择哪些公司? |
| 已激活公司 | env.companies.ids,即 company_ids | 本次操作在哪个范围内生效? |
| 当前公司 | env.company.id,即 company_id | 这次取值用的是哪家公司的数据? |
Wavect 在核对 20.0 的环境实现时发现两个容易踩空的地方。第一,已激活公司为空列表时会回退到用户的公司,并不表示「拒绝全部公司」——想用空上下文做出「谁都不许看」的效果,是把一个实现细节当成了政策。第二,sudo 模式会跳过这层合理性检查,所以用高权限账号跑通测试,不能证明普通用户的隔离成立。
所以一份写「多公司隔离正常」的验收报告,实际上什么都没说。它没有回答:哪些公司被授权、本次激活了哪几家、取到的值是 100.00 还是 120.00。这三个问题的答案不同,结论可能完全相反。
三、最危险的一行:只测禁止,会把坏配置当成功
Riedl 用一个仅依赖标准库的小型 Python 模型,跑了 16 个虚构政策用例,执行日期 2026 年 11 月 5 日,全部得到预期观察结果。这些用例的价值不在结论,而在于它们展示了一件事:权限验收必须成对测。
| 用例(虚构政策) | 预期 | 观察 |
|---|---|---|
| 已激活 A 中的本人记录 | 允许 | 允许 |
| 已激活 A 中的他人记录 | 拒绝 | 拒绝 |
| B 已授权但未激活,读取 B 记录 | 拒绝 | 拒绝 |
| 增加一个宽泛组授权后,读取他人的 A 记录 | 允许(授权被扩大) | 允许 |
| 宽泛组 + 全局公司限制,未激活 B | 拒绝 | 拒绝 |
| 省略全局公司限制 | 暴露未激活 B | 允许(错误配置) |
| 并列「只能 A」与「只能 B」两条全局限制 | 合法 A 记录本应可读 | 被阻止 |
| 只有全局限制、没有组授权 | 拒绝 | 拒绝 |
| 把旧的分层政策简单转换 | 旧拒绝应保持拒绝 | 变为非预期允许 |
| 当前公司切换 A / B,读同一张单据的公司值 | 两个不同值 | 100.00 / 120.00 |
| 可见的 A 记录关联到 B 记录 | 访问通过,关系检查应失败 | 关系不一致 |
| 已激活公司传空列表 | 需明确政策 | 回退到成员资格,B 可读 |
表里有三行值得单独拎出来说。
第一行是「省略全局公司限制」。它证明那条限制不是装饰,而是唯一的边界:有它在,宽泛授权也只能看到已激活公司的数据;没它,未激活公司的记录直接暴露。而这条限制在迁移中最容易被当成「冗余配置」删掉,因为删掉之后系统跑得更顺——没有任何报错。
第二行是那对互相矛盾的限制。「只能 A」和「只能 B」并列,会让合法的 A 记录被一并阻止。如果验收只测禁止访问,这套坏配置会拿满分:该挡的都挡住了。所以每一项重要的拒绝,都必须配一个允许对照,证明用户仍然能干活。这不是严谨癖,这是防止「全部阻断」这种最糟的结果伪装成最安全的结果。
第三行是「简单转换旧的分层政策」。一种典型的错误改写,是把旧的宽泛模型授权保留成新的宽泛记录授权,再与较窄的授权并列;两个组的并集,让旧的「拒绝他人记录」变成了「允许」。官方访问转换源码(19.4-00-ir-access.py)会结合组做推断,并对宽泛 ACL 组与较窄规则的交互发出警告。但要注意:警告是复核要求,不是通过凭证;反过来,日志里没有警告,也不等于业务政策就没被动过。
最没用的证据是截图。菜单里那一行消失了,只说明前端隐藏了入口,不说明底层的读、写、删除被拒绝。要用直接记录标识去测:这个身份能不能按 ID 取到那条记录,能不能改,改完的最终状态是什么。
四、验收矩阵,与 CIO 的三条动作
把上面这些东西落成一张可签字的矩阵,需要的维度其实很少:角色 × 公司上下文 × 操作。每个格子填两样东西——获批的预期,和升级系统上的实际证据。证据至少要有实际组集快照、构建版本、入口、记录标识、公司上下文;破坏性操作只在演练环境的受控记录上做,并且必须包含一条「允许修改」的用例,否则「全部拒绝」也能通过。
还有一个前置条件常被跳过:模块得先有 20 版。第三方 Odoo 伙伴 CloudSpinx 在统计 OCA 仓库后给出的数字是,能在 Odoo 17 上安装的约 2000 个模块中,1073 个有 19 版,只有 66 个有 20 版;OCA 20.0 分支上的 137 个模块文件夹里,45 个是不可安装的占位。没有可装的模块,谈不到权限矩阵——这跟 11 月初我们写过的那道「迁移悬崖」是同一堵墙的两面。
16 个用例,四类覆盖。2026-11-05 在本地权限模型上执行的政策用例数量,覆盖可见性、公司上下文、取值与关联四类,全部得到预期观察结果。数量不多,但足以说明"成对测"和"只测拒绝"的差别。
给 CIO 和数字化负责人的三条动作,按能省下的麻烦排序:
第一,把验收结论从「能登录、菜单对」改成「允许与拒绝成对通过」。每个关键角色至少配两个公司上下文(仅 A 激活、A/B 都激活),各配一条允许用例和一条拒绝用例,用直接记录 ID 测而不是点菜单。报告里必须能回答那三个公司问题,否则这一页不算完成。
第二,把转换器的每一条警告落成处理决定。逐条写清:影响哪个组、哪个操作、哪类记录;结论是收紧、保留还是政策变更;谁批准。特别要接受一件事——旧拒绝不必然是正确的新规则,旧允许也不值得保留。权限迁移不是复制历史,是重新签一次政策。
第三,访问通过之后,单独验「值」和「关联」。可见不等于取值正确:同一张单据在不同当前公司下可能给出 100.00 和 120.00;可读也不等于关联合法:跨公司的关联要单独验 check_company 与 _check_company_auto。还有服务账号和定时任务——它们不走人工路径,必须单独记录执行身份与公司上下文,并放一条「不得触碰」的受控记录在旁边。
口径说明:Wavect 在文中明确声明,其核验基于 Odoo 19/20 官方文档、20.0 访问实现与源码转换脚本,未运行 Odoo、未执行数据库升级、未运行官方转换器;16 个用例是小型 Python 模型的结果,下载的原生验收矩阵仍为 NOT_RUN,不构成对真实数据库的安全评估。OCA 模块数量出自 CloudSpinx(第三方 Odoo 伙伴)对 270 个非归档仓库的统计,未获 OCA 官方确认,仅用于判断量级。本文引用这些材料说明验收方法与风险结构,不对任何具体部署下结论。
权限迁移最危险的结果,不是「该看的看不到」,而是「不该看的看到了,而且没人发现」。前者会有人投诉,后者只会安静地留在日志里。
这也是为什么 Odoo 20 这次改动值得单独写一篇。它不是一个功能更新,而是一次语义变更:把「两层叠加」变成「一次求值」,把「配置是否正确」变成「组合是否正确」。组合的正确性没有默认值,只能靠成对的用例证明。
对正在排 19 到 20 升级窗口的企业来说,这件事的顺序应该倒过来:先定政策与验收矩阵,再谈升级日期。因为升级窗口可以谈,权限扩权一旦上线,你面对的就不是一个项目问题,而是一次需要向审计解释的事件。
资料来源:Wavect《Odoo 20 权限迁移:如何验收多公司隔离?》(作者 Kevin Riedl,资料核验日期 2026-11-05,含 Odoo 19/20 安全参考对比、ir.access 判定式、三个公司上下文、16 个政策用例观察结果、官方转换源码 19.4-00-ir-access.py 的警告机制、可运行权限模型与原生验收矩阵 NOT_RUN 声明);Odoo 官方文档 20.0 与 19.0 安全参考(developer/reference/backend/security)、20.0 访问域求值实现(base/models/ir_access.py)、环境实现(orm/environments.py)、多公司指南(howtos/company.rst,含 check_company 与 _check_company_auto);CloudSpinx《Odoo 17 End of Support: What an Upgrade Costs in Kenya》(OCA 270 个非归档仓库、17.0–20.0 分支逐模块 manifest 统计,2026 年 10 月后更新)。
数据口径说明:16 个用例均为虚构政策的本地模型结果,未在真实数据库执行,不能作为安全评估结论;公司值 100.00 与 120.00 为示例数值,非真实业务数据;OCA 模块数量(2000 / 1073 / 66、137 个文件夹中 45 个占位)为第三方伙伴统计口径,与 OCA 官方发布节奏可能存在时间差,采购与升级决策前应以目标版本分支实际 manifest 为准。本号 2026-11-01 曾覆盖 Odoo 20 社区版迁移悬崖与 OCA 依赖风险,本篇聚焦权限语义变更后的验收方法,不重复其版本生命周期与技术断点清单。
众谛信息(Zodioo)· 企业数字化观察 · 2026-11-11
