当前位置：首页 > news >正文

MateCloud邮件通知：SMTP配置与模板引擎使用指南

news 2026/7/11 16:48:33

MateCloud邮件通知：SMTP配置与模板引擎使用指南

【免费下载链接】matecloud🔥MateCloud是一款基于Spring Cloud Alibaba的微服务架构。目前已经整合Spring Boot 4.0.7、 SpringCloud 2025、Spring Cloud Alibaba 2025、Spring Security Oauth2、Feign、Dubbo、JetCache、RocketMQ等，支持多租户的低代码平台，Saas平台开发套件项目地址: https://gitcode.com/GitHub_Trending/ma/matecloud

MateCloud作为基于Spring Cloud Alibaba的微服务架构，提供了完整的邮件通知功能，支持多租户环境下的SMTP配置与模板化邮件发送。本文将详细介绍如何在MateCloud中快速配置邮件服务并使用模板引擎发送个性化邮件。

一、SMTP服务核心配置

SMTP（Simple Mail Transfer Protocol）是MateCloud邮件通知系统的基础，通过配置SMTP服务器信息实现邮件的发送功能。在MateCloud中，SMTP配置主要通过Nacos配置中心进行管理，支持多环境隔离和动态调整。

1.1 基础配置项说明

核心SMTP配置参数包括：

spring.mail.host: SMTP服务器地址（如smtp.example.com）
spring.mail.port: SMTP服务器端口（通常为465或587）
spring.mail.username: 发件人邮箱账号
spring.mail.password: 邮箱授权码（非登录密码）
spring.mail.properties.mail.smtp.ssl.enable: 是否启用SSL加密（建议开启）

这些配置可以在Nacos配置中心的mate-infra-dev.yml或mate-infra-prod.yml文件中进行设置，实现不同环境的差异化配置。

1.2 系统配置界面操作

MateCloud提供了直观的系统配置界面，通过"系统管理"→"配置中心"→"参数设置"可以快速管理邮件相关配置。

在配置界面中，可以添加或修改以spring.mail.为前缀的配置项，无需重启服务即可生效，极大提升了配置灵活性。

二、邮件模板引擎使用

MateCloud的邮件通知系统集成了模板引擎，支持HTML格式邮件的动态生成，满足验证码、通知、营销等多种业务场景需求。

2.1 模板引擎基础架构

MateCloud的邮件模板功能基于延迟队列事件驱动架构实现，主要涉及以下核心组件：

EmailService: 邮件发送核心服务
DelayQueueService: 延迟队列服务，支持定时发送（如用户注册后1小时发送欢迎邮件）
模板引擎: 支持变量替换的HTML模板解析器

相关实现代码位于mate-biz/mate-notice/src/main/java目录下，通过领域驱动设计(DDD)模式组织代码结构，确保业务逻辑的清晰性和可扩展性。

2.2 典型应用场景

用户注册欢迎邮件

当用户完成注册后，系统会自动触发欢迎邮件的发送流程：

// 调度延迟任务 delayQueueService.offer("user:welcome-email", userId, 3600); // 1小时后执行

在延迟队列监听器中处理邮件发送：

@DelayQueueListener(topic = "user:welcome-email") public void handleWelcomeEmail(String userId) { User user = userRepository.getById(userId); emailService.sendWelcomeEmail(user.getEmail(), user.getNickName()); }

动态模板变量替换

邮件模板支持多种动态变量，如用户昵称、验证码、有效期等，典型的模板内容可能包含：

<h1>欢迎您，{{nickName}}！</h1> <p>您的注册验证码是：<strong>{{code}}</strong></p> <p>有效期：{{expireTime}}分钟</p>

三、多租户环境下的邮件配置

MateCloud作为支持多租户的低代码平台，在邮件通知功能上也做了租户隔离设计，确保不同租户可以使用各自的邮件服务配置。

3.1 租户级配置覆盖

系统级SMTP配置为所有租户提供默认值，租户可以在自己的配置中覆盖这些参数，实现独立的邮件发送能力。租户配置优先级高于系统配置，确保个性化需求的满足。

3.2 邮件发送记录与审计

所有邮件发送记录会被保存在数据库中，相关表结构定义如下：

CREATE TABLE `mate_notice_record` ( `id` bigint NOT NULL COMMENT 'ID', `tenant_id` bigint NOT NULL COMMENT '租户ID', `target` VARCHAR(255) NOT NULL COMMENT '目标地址(email/phone)', `template_id` bigint NOT NULL COMMENT '模板ID', `status` tinyint NOT NULL COMMENT '发送状态', `send_time` datetime DEFAULT NULL COMMENT '发送时间', PRIMARY KEY (`id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='通知发送记录';

通过mate_notice模块的管理界面，可以查看和跟踪所有邮件的发送状态，便于问题排查和审计。