Odoo自定义登录模板调用OTP相关QWeb模板报外部ID不存在错误
Odoo QWeb 调用模板报「External id not found」问题排查与解决
核心问题原因
报错本质是调用的OTP模板不符合Odoo后端渲染的标识匹配规则:
- 目前OTP模板定义在
<templates>块中,这类块的模板是前端JS专用QWeb模板,只会被打包进前端静态资源bundle,不会在后端ir_model_data表生成可被t-call识别的外部标识符(External ID)。 - 后端
t-call语法仅能匹配定义为ir.ui.view数据记录的模板,这类模板的External ID规则为「当前模块名.模板标签的id属性值」,和前端模板的t-name是完全独立的两套标识体系,无法跨场景调用。
分步解决方法
- 修正OTP模板的定义方式
把OTP模板从前端<templates>块中移出,改为定义为独立的后端可调用模板记录,示例代码:<?xml version="1.0" encoding="utf-8"?> <odoo> <!-- 定义后端可调用的OTP块模板,id是后续生成External ID的核心标识 --> <template id="otp_service" name="OTP交互组件块"> <div> <h1>Hello world</h1> <!-- 后续可在此嵌入OTP输入框、发送按钮的静态结构 --> </div> </template> <!-- 自定义登录页继承模板 --> <template id="custom_login" name="Custom login" inherit_id="web.login"> <xpath expr="//p[hasclass('alert-success')]" position="after"> <!-- 此处调用的External ID 为 模块名.上面定义的id,和原调用值保持一致 --> <t t-call="bulk_sms_otp_service.otp_service"/> </xpath> </template> </odoo> - 检查模块清单的文件加载配置
确认定义了OTP模板的XML文件路径,已经添加到模块__manifest__.py的data数组中,且文件加载顺序排在登录页自定义模板之前,避免加载时出现顺序报错:# __manifest__.py 示例配置 'data': [ # 其他原有视图、数据文件 'views/otp_template.xml', # OTP模板文件排在登录模板之前 'views/custom_login_template.xml', ] - 验证External ID是否正常生成
完成修改后升级模块,可进入「设置 > 技术 > 建模 > 外部标识符」界面,搜索模块名bulk_sms_otp_service,确认存在值为otp_service的标识符条目,不存在则说明定义或加载环节存在遗漏。
常见避坑提示
- 不要混用前端QWeb模板和后端渲染模板的定义规则:需要被后端
t-call调用的内容,必须定义为<odoo>根标签下的独立<template>记录,不要放在<templates>静态资源块中。 - 不要将模板的
t-name属性值和后端External ID绑定,两者无关联,后端调用不识别t-name值。 - 确认
t-call拼接的模块名和模块实际技术名(模块文件夹名)完全一致,拼写偏差会直接导致External ID匹配失败。
内容的提问来源于stack exchange,提问作者Almabud
相关产品推荐
相关产品推荐

