本文详解 Odoo 16 下如何正确创建持久化讨论频道（mail.channel）并可靠发送消息，重点解决因模块依赖缺失或 XML 解析失败导致的 KeyError: 'mail.channel' 错误，并提供可直接复用的 Python 发送方案。
本文详解 odoo 16 下如何正确创建持久化讨论频道（mail.channel）并可靠发送消息，重点解决因模块依赖缺失或 xml 解析失败导致的 `keyerror: 'mail.channel'` 错误，并提供可直接复用的 python 发送方案。
在 Odoo 16 中，通过 XML 数据文件预创建 mail.channel 记录时频繁报错 KeyError: 'mail.channel'，其根本原因在于：mail.channel 模型由 mail 模块定义，若当前模块未显式声明对 mail 的依赖，Odoo 在加载 XML 数据时模型尚未注册，导致解析失败。该错误与 Odoo 15 及更早版本的行为一致，但因 Odoo 16 对模块加载顺序和模型可用性校验更严格而尤为突出。
✅ 正确做法：确保模块依赖 + 使用 Python 动态创建（推荐）
1. 声明对 mail 模块的硬依赖
在 __manifest__.py 中，将 'mail' 明确添加至 depends 列表：
'depends': [
'base',
'mail', # ← 关键！必须添加，否则 mail.channel 不可用
'project', # 因引用了 project.group_project_manager，也需依赖
],⚠️ 注意：仅在 data 中引用 project.group_project_manager 并不足以自动引入 project 模块依赖——Odoo 不会自动推导 XML 中 ref 所需的模块依赖，必须手动声明。
2. 修正 XML 文件（可选，但需配合依赖）
若仍希望使用 XML 初始化频道，确保 custom_channels.xml 文件路径已正确加入 manifest（如 'data/custom_channels.xml'），且内容语法兼容 Odoo 16（Command.link 已支持）：
<?xml version="1.0" encoding="utf-8"?>
<odoo noupdate="1">
<record id="channel_mailing" model="mail.channel">
<field name="name">Mailing queue reports</field>
<field name="description">Mailing tasks status and history</field>
<field name="public">groups</field>
<field name="group_public_id" ref="project.group_project_manager"/>
<field name="group_ids" eval="[(4, ref('project.group_project_manager'))]"/>
</record>
</odoo>? 提示：eval="[(4, ref(...))]" 是 Odoo 16 推荐的写法（Command.link 在 XML 中不被直接识别，应使用传统 (4, id) 元组语法）。若坚持使用 Command，须改用 Python 初始化（见下文）。
3. 推荐方案：Python 初始化 + 消息发送（更可控、易调试）
在模型的 _create_default_channel() 方法或 post_init_hook 中动态创建频道并发送消息，避免 XML 加载时序问题：
from odoo import api, models, _
from odoo.addons.mail.models.mail_message import MailMessage
def post_init_hook(cr, registry):
"""模块安装后自动创建频道并发送欢迎消息"""
env = api.Environment(cr, SUPERUSER_ID, {})
channel_model = env['mail.channel']
# 创建频道（若不存在）
channel = channel_model.search([('name', '=', 'Mailing queue reports')], limit=1)
if not channel:
channel = channel_model.create({
'name': 'Mailing queue reports',
'description': 'Mailing tasks status and history',
'public': 'groups',
'group_public_id': env.ref('project.group_project_manager').id,
'group_ids': [(4, env.ref('project.group_project_manager').id)],
})
# 发送测试消息（关键：使用 mail.message.create）
env['mail.message'].create({
'message_type': 'comment',
'subtype_id': env.ref('mail.mt_comment').id,
'model': 'mail.channel',
'res_id': channel.id,
'body': '<p>✅ 频道已成功初始化 —— Mailing queue reports</p>',
'author_id': env.user.partner_id.id,
})并在 __manifest__.py 中注册钩子：
'post_init_hook': 'post_init_hook',
4. 运行时发送消息（业务逻辑中调用）
当需要在业务逻辑（如 cron 或按钮动作）中向频道发消息时，复用上述模式：
def send_to_mailing_channel(self, message_body):
channel = self.env.ref('my_module.channel_mailing', raise_if_not_found=False)
if not channel:
# 回退：按名查找（更健壮）
channel = self.env['mail.channel'].search(
[('name', '=', 'Mailing queue reports')], limit=1
)
if channel:
self.env['mail.message'].create({
'message_type': 'comment',
'subtype_id': self.env.ref('mail.mt_comment').id,
'model': 'mail.channel',
'res_id': channel.id,
'body': message_body,
'author_id': self.env.user.partner_id.id,
})? 关键注意事项总结
- 依赖是前提：depends = ['mail'] 缺一不可，否则所有 mail.* 模型均不可用；
- XML vs Python：XML 简洁但脆弱（依赖加载顺序），Python 初始化更灵活、可加异常处理与幂等逻辑；
- 消息模型选择：务必使用 mail.message 而非 mail.channel.message_post()（后者在 Odoo 16 中对频道支持不稳定）；
- 事务提交：若在非自动提交上下文（如自定义 cursor）中操作，需显式调用 cr.commit()；
- 权限验证：确保目标用户所属组拥有 mail.channel 的读/写权限（通常 mail 模块已配置基础规则）。
通过以上结构化实践，可彻底规避 KeyError: 'mail.channel'，并构建稳定、可维护的 Odoo 16 讨论频道消息系统。
