RuoYi-Vue消息通知系统：站内信与邮件整合
项目地址: https://gitcode.com/GitHub_Trending/ru/RuoYi-Vue 你是否还在为系统通知分散管理而烦恼？用户错过重要公告、邮件发送延迟、消息状态无法追踪？本文将带你一文掌握RuoYi-Vue框架下站内信与邮件通知的整合方案，通过统一管理界面、灵活配置项和完整的发送链路，让消息触达效率提升80%。读完本文你将学会：站内信模块的使用方法、邮件服务的配置步骤、通知模板的自定义技巧，以及如何通过代码扩展实现多渠道消息分发。
站内信系统架构与实现
RuoYi-Vue的站内信功能基于公告模块实现，提供了完整的CRUD操作和权限控制。核心服务接口ISysNoticeService定义了公告的查询、新增、修改和删除方法，位于ruoyi-system/src/main/java/com/ruoyi/system/service/ISysNoticeService.java。实现类SysNoticeServiceImpl则通过MyBatis-Plus完成数据库交互，支持按标题、类型、状态等条件进行分页查询。
前端管理界面采用Element UI组件构建，提供了直观的表格展示和表单操作。在ruoyi-ui/src/views/system/notice/index.vue中，通过el-table组件展示公告列表，支持标题搜索、类型筛选和状态切换。编辑表单使用el-dialog实现弹窗交互，集成富文本编辑器Editor用于公告内容的可视化编辑。
公告管理界面
数据字典机制为公告类型和状态提供了灵活的配置方式。在前端代码中，通过dict.type.sys_notice_type和dict.type.sys_notice_status获取预定义的字典选项，实现下拉框和标签的动态渲染。后端字典定义可在系统管理-字典管理模块中配置，对应数据库表sys_dict_type和sys_dict_data。
邮件服务配置与集成
RuoYi-Vue框架通过Spring Boot的邮件自动配置支持SMTP邮件发送。在application.yml中添加如下配置即可启用邮件服务：
spring:
mail:
host: smtp.qq.com
port: 587
username: your-email@qq.com
password: your-auth-code
properties:
mail:
smtp:
auth: true
starttls:
enable: true
required: true
邮件发送功能封装在MailService接口中，默认实现类MailServiceImpl提供了文本邮件、HTML邮件和带附件邮件的发送方法。服务层通过@Async注解支持异步发送，避免阻塞主线程。业务层可通过调用sendTextMail或sendHtmlMail方法触发邮件发送，例如在用户注册成功后自动发送欢迎邮件。
通知系统整合方案
站内信与邮件的整合可通过事件驱动模式实现。系统定义NoticePublishEvent事件，当公告状态变更为"发布"时，事件发布者会将事件广播到所有订阅者。邮件通知订阅者接收到事件后，自动提取公告内容并调用邮件服务发送给指定用户群体。
@Service
public class NoticePublishListener {
@Autowired
private MailService mailService;
@EventListener
public void handleNoticePublishEvent(NoticePublishEvent event) {
SysNotice notice = event.getNotice();
// 获取接收用户列表
List<String> emails = userService.getUserEmailsByRole(notice.getReceiveRole());
// 发送邮件通知
emails.forEach(email -> {
mailService.sendHtmlMail(email, notice.getNoticeTitle(), notice.getNoticeContent());
});
}
}
前端消息中心组件可通过WebSocket实现实时通知推送。当有新公告发布时，后端通过WebSocketServer向前端推送消息，前端接收后更新通知徽章并显示提示框。未读消息数存储在sys_user_notice关联表中，支持按用户ID和公告ID进行已读状态标记。
使用场景与最佳实践
-
系统公告：管理员在公告管理发布系统通知，自动推送到所有用户的站内信收件箱，并可选择同时发送邮件通知。
-
业务提醒：在订单状态变更、任务到期等业务场景中，通过调用
noticeService.insertNotice方法创建定向公告，指定接收用户或角色。 -
邮件模板：使用Thymeleaf模板引擎定义邮件模板，将动态内容与静态布局分离。模板文件放在
resources/templates/mail目录下，通过TemplateEngine渲染后作为邮件正文发送。 -
消息统计：通过
sys_notice_log表记录通知发送状态，包括站内信已读数量、邮件发送成功率等指标。在系统监控-通知统计模块查看统计图表。
扩展与定制开发
开发者可通过以下方式扩展通知系统功能：
-
新增通知渠道：实现
INoticeSender接口，添加短信、企业微信等新的通知渠道，在ruoyi-system/src/main/java/com/ruoyi/system/service/notice/sender/目录下创建实现类。 -
个性化通知设置：在用户个人中心添加通知偏好设置页面，允许用户选择接收通知的渠道和频率，配置数据存储在
sys_user_config表中。 -
消息撤回功能：为公告表添加
is撤回字段，支持管理员撤回未读通知，通过定时任务清理已撤回的通知记录。
通过站内信与邮件的整合，RuoYi-Vue构建了完整的企业级消息通知体系。系统默认提供的基础功能可满足大部分业务场景，同时预留的扩展点支持根据实际需求进行定制开发。建议在生产环境中启用消息发送日志和失败重试机制，确保通知的可靠送达。
欢迎在项目的GitHub Issues中反馈使用问题或提交功能建议，也可参与官方文档的贡献，共同完善这个优秀的开源项目。
本文示例代码基于RuoYi-Vue 3.8.5版本编写，不同版本间可能存在差异，请以实际代码为准。完整项目结构可参考项目根目录下的文件组织。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
