将模块从Odoo15迁移至Odoo16时遭遇RPC_ERROR问题求助

错误信息 #

RPC_ERROR: Odoo Server Error
at makeErrorFromResponse (web.assets_backend.js:10383:19) (/web/static/src/core/network/rpc_service.js:34)
at XMLHttpRequest. (web.assets_backend.js:10436:27) (/web/static/src/core/network/rpc_service.js:87)

排查与解决步骤 #

• 提取服务器端核心错误：客户端RPC_ERROR仅为表层提示，必须查看Odoo服务器日志（默认路径/var/log/odoo/或启动终端输出），定位Python层面的具体报错，比如模型字段不兼容、方法重写错误、依赖缺失等。
• 适配前端代码变更：Odoo16升级了OWL框架，若自定义模块包含前端组件：
  • 核对rpc调用的参数结构，Odoo16部分RPC接口的参数顺序、命名规则有调整。
  • 检查组件生命周期钩子（如willStart、mounted）的使用方式，OWL v2与v1存在语法差异。
  • 执行命令odoo-bin --update=web --clear-cache清理前端缓存，强制加载新资源。
• 验证模型与字段兼容性：
  • 排查自定义模型中是否使用Odoo15废弃的字段类型或属性，比如oldname的使用逻辑、@api.depends装饰器的关联字段是否正确。
  • 确认__manifest__.py中的depends依赖列表，Odoo16核心模块的依赖关系有调整，需同步更新。
• 拆分模块迁移测试：多模块迁移时，先单独迁移基础模块，逐步添加依赖模块，定位触发错误的具体模块。
• 检查数据库迁移脚本：若模块包含migrations目录下的迁移脚本，验证SQL语句是否兼容PostgreSQL 12+（Odoo16最低要求），确保脚本能正常执行。

内容的提问来源于stack exchange，提问作者alrabie mhjob