PocketBase中扩展邮件模板关联字段的技术实现

在PocketBase项目中，开发者经常遇到需要在邮件模板中使用关联字段数据的需求。本文深入探讨这一技术问题的解决方案，帮助开发者更好地理解PocketBase的邮件系统工作机制。

问题背景

在用户密码重置邮件场景中，开发者希望展示用户所属团队的支持电话号码。然而，PocketBase默认的邮件模板变量替换机制不支持直接访问关联集合的字段。例如，虽然可以使用{RECORD:email}获取用户邮箱，但尝试使用{RECORD:team.support_phone_number}时，系统无法自动展开team关联字段。

技术解决方案

PocketBase提供了强大的钩子机制来解决这类定制化需求。具体来说，可以使用onMailerRecordPasswordResetSend事件钩子，在发送密码重置邮件前对邮件内容进行自定义处理。

实现步骤

1. 创建钩子文件：在pb_hooks目录下创建JavaScript钩子文件
2. 访问记录数据：通过e.Record获取当前用户记录
3. 查询关联数据：使用PocketBase的DAO方法获取关联的团队信息
4. 修改邮件内容：对e.message.html和e.message.text进行内容替换

代码示例

onMailerRecordPasswordResetSend((e) => {
  // 获取关联的团队记录
  const team = e.Record.expand?.team || await pb.collection('teams').getOne(e.Record.team)
  
  // 替换邮件内容
  if (team?.support_phone_number) {
    e.message.html = e.message.html.replace(
      '{RECORD:team.support_phone_number}', 
      team.support_phone_number
    )
    e.message.text = e.message.text.replace(
      '{RECORD:team.support_phone_number}', 
      team.support_phone_number
    )
  }
  
  e.next()
})

注意事项

1. 字符串替换方法：JavaScript的replaceAll方法不会原地修改字符串，必须将返回值赋回原变量
2. 性能考虑：频繁查询关联数据可能影响性能，建议合理使用缓存
3. 错误处理：应妥善处理关联数据不存在的情况
4. 钩子执行顺序：确保在修改完成后调用e.next()继续执行后续钩子

扩展应用

此技术方案不仅适用于密码重置邮件，还可应用于：

• 用户注册欢迎邮件
• 账户变更通知邮件
• 系统告警邮件等场景

通过掌握PocketBase的钩子机制，开发者可以灵活定制各种业务场景下的邮件内容，实现更丰富的用户交互体验。