升级Odoo 16自定义模块时遭遇「模型字段不存在」错误

• 彻底清理服务器端缓存
  浏览器缓存无效，需针对Odoo自身清理：

  • 重启服务时携带清理缓存参数：./odoo-bin --clear-cache
  • 进入开发者模式，点击「设置->技术->用户界面->清除缓存并重新加载」
  • 若开启多进程（workers>0），先彻底终止所有Odoo进程：pkill -f odoo-bin，再重新启动服务，避免旧进程残留缓存。

• 校验模块加载与字段定义

  • 检查模块__manifest__.py中的depends列表，确保自定义模块在依赖模块之后加载，尤其是继承模型所属模块必须包含在依赖中。
  • 确认模型文件的_inherit设置正确，字段定义无语法错误，示例：

    class TargetModel(models.Model):
        _inherit = 'existing.model.name'
        transfer_point_domain = fields.Char(string="Transfer Point Domain")
    

  • 排查是否有其他模块同时修改该模型，可能因加载顺序导致字段被覆盖或未加载。

• 数据库层面验证字段状态

  • 直接登录数据库，查询对应表是否存在目标字段，例如模型res.partner对应表res_partner，执行SQL：

    SELECT transfer_point_domain FROM res_partner LIMIT 1;
    

  • 若字段不存在，说明Python代码未被加载：检查模型文件是否在模块models目录下，__init__.py是否导入该文件，模块是否处于已安装状态。
  • 若字段已存在但升级报错，可临时移除视图中对该字段的引用，升级成功后再添加视图字段重新升级。

• 临时禁用模型缓存优化
  Odoo 16新增了模型结构缓存机制，可在配置文件中添加以下配置：

  [options]
  model_cache = False
  

  重启服务后尝试升级，此方法仅用于排查问题，长期使用会影响系统性能。

• 通过debug日志定位问题
  启动Odoo时开启debug级日志：

  ./odoo-bin --log-level=debug
  

  升级模块时查看日志，寻找模型加载、字段注册相关的错误信息，比如继承失败、字段参数错误等。

内容的提问来源于stack exchange，提问作者Panagiotis Anagnostakis