Odoo 19 工作流调试概览与排错实操

调试 Odoo 19 会涉及 Python 模型、OWL、JSON-RPC 与记录规则。HTTP / OWL / 前端打包也有变化，部分旧习惯会失效。优先用可落地的检查手段。

1. 看 JSON-RPC 正文，别只看 HTTP 状态码

多数业务错误仍返回 HTTP 200，真正异常在 JSON-RPC 的 error 里：

json 复制代码

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": 200,
    "message": "Odoo Server Error",
    "data": {
      "name": "odoo.exceptions.ValidationError",
      "debug": "Traceback ...",
      "message": "The field 'email' is required."
    }
  }
}

HTTP 重构后已无 exception_type------请用 data.name。

客户端取值：response.error?.data?.name。

2. 服务端调试日志

配置文件 odoo.conf：

ini 复制代码

[options]
log_level = debug
log_handler = :DEBUG

启动命令：

bash 复制代码

python odoo-bin --log-level=debug --log-handler=:DEBUG -c odoo.conf

按模块定点输出日志，减少噪音：

bash 复制代码

--log-handler=odoo.addons.your_module:DEBUG

参考文件：odoo.conf.debug.sample

3. 方法内断点（仅开发环境使用）

python 复制代码

def action_confirm(self):
    breakpoint()  # 或: import pdb; pdb.set_trace()
    return super().action_confirm()

⚠️ 切勿留在生产环境------进程会挂起且不一定有明确报错。

4. 拦截前端 RPC

按钮 / OWL 触发的流程常走 /web/dataset/call_kw。

操作：浏览器 DevTools → Network，过滤 XHR，查看请求/响应 JSON。

临时 RPC 包装脚本（上线提交前务必删除）：static/src/rpc_debug_snippet.js。

5. 抛出正确的异常类

python 复制代码

from odoo.exceptions import UserError, ValidationError, AccessError, MissingError

raise UserError("You can't confirm an order without a customer.")
raise ValidationError("The delivery date cannot be in the past.")
raise AccessError("You don't have rights to approve this record.")
raise MissingError("Record missing.")

建议：少用裸 ValueError / Exception------前端映射与调试信息较差。

示例代码：models/sale_order.py

6. 自动化可能"静默无果"

服务器动作 / 定时任务 / 字段自动化有独立事务。

域名不匹配 → 0 行数据处理 → 不报错
抛出真实异常 → 事务回滚、前端弹窗提示

无 SSH 时，直接查询 ir_logging 日志表：

sql 复制代码

SELECT name, level, message, create_date
FROM ir_logging
WHERE level IN ('ERROR', 'WARNING')
ORDER BY create_date DESC
LIMIT 50;