跳到主要内容

常见问题

遇到问题先记录 Odoo 版本、模块版本、数据库、浏览器、入口和错误提示。不要直接修改数据库来绕过权限或绑定校验。

设置仍在一般设置​

确认实际启动的代码目录和数据库。重启后还需升级对应模块，尤其 Editor 和已安装的 Templates，再刷新页面。数据库旧视图不会仅因代码文件更新而自动替换。

关闭编辑后出现 403​

普通只读预览应保留。先确认是否误进编辑或设计路由。若提示编辑被禁用，记录入口与 URL；不要靠永久开启编辑来掩盖错误入口。

PDF 仍使用 PDF.js​

保存 PDF 默认预览器为本地 Office，刷新业务页面，确认测试入口被 MT Office 接管。手动打开 PDF.js 地址不会被此设置自动改写。

标准报表没有先预览​

确认已选择并保存先预览，动作属于标准 qweb-pdf，浏览器允许弹窗且 wkhtmltopdf 可用。邮件、API 和自定义下载不属于统一接管范围。

旧源码按钮仍然出现​

先确认运行代码已更新，再升级负责该页面的 Viewer。仅升级 Editor 或 Templates、或者仅重启，可能仍使用数据库里旧 Viewer 页面。不要据此认定一定是浏览器缓存。

模板没有字段面板或设计按钮​

确认 Templates 已安装、绑定模型和文件完整、文件类型受支持、全局编辑已开启，且用户具有模板管理权限。只读查看器不是设计器。

生成结果为空或仍有占位符​

核对模板主模型与业务记录一致，确认来源字段确实有值。关联对象为空时，子字段也会为空。明细不展开时检查重复行配置，而不只是列标题。

二维码出现加载图片提示​

保留模板副本，记录字段、位置、环绕方式和移动步骤。保存重开后检查重复控件，再重新生成与扫码。不要直接删除唯一有效绑定。

二维码报 Python 渲染后端错误​

先核对正在运行的分支与模块版本，确认错误发生在当前代码还是旧环境。当前 19 版本二维码生成使用 qrcode 与图片处理；历史 renderPM 或 rlPyCairo 错误应沿实际堆栈检查，不能盲目往系统 Python 安装包。

缩略图一直显示生成中​

先区分缩略图与文档实际预览能否打开，再检查编辑或转换入口、浏览器状态与后台错误。记录文件类型、大小和复现步骤，不把所有等待都判断成同一个权限问题。

运行记录模板为空​

区分历史名称与当前模板关联。原模板删除后当前关联可能为空；无法确认的旧记录应保留未知状态，不能猜测重绑定。

保存后重新打开没有修改​

核对是否等待保存成功、是否重新打开同一附件或业务记录，以及用户写入权限。设计模板与修改生成结果不同，检查是否保存了正确对象。