Java消息通知模块应解耦业务与发送逻辑,采用统一接口、多实现策略、异步执行和可配置化;邮件用Spring Boot的JavaMailSender,短信对接云厂商API并封装为SmsService,通过MessageSender抽象层统一调用,支持策略+工厂模式扩展通道,异步执行并保障可靠性。

Java中实现短信或邮件通知模块,核心在于解耦业务逻辑与消息发送,采用统一接口 + 多种实现策略 + 异步执行 + 可配置化。不推荐硬编码调用第三方SDK,而应设计可插拔的消息通道机制。
邮件通知:基于Spring Boot + JavaMailSender
Spring Boot对JavaMail提供了开箱即用的支持,只需引入依赖并配置SMTP参数即可发送文本、HTML邮件甚至带附件的邮件。
- 添加spring-boot-starter-mail依赖
- 在application.yml中配置邮箱服务(如QQ邮箱、163邮箱或企业SMTP)
- 注入JavaMailSender,封装sendEmail(To, Subject, Content)方法
- HTML邮件需设置MimeMessageHelper.setHtml(true);附件使用addAttachment()
短信通知:对接云服务商API(如阿里云、腾讯云、容联云)
短信需调用厂商HTTP接口,建议封装为独立Service,屏蔽底层协议细节,并加入签名、模板ID、频率限制等通用处理逻辑。
- 定义SmsService接口,提供send(String phone, String templateCode, Map
params) - 各厂商实现类(如AliyunSmsServiceImpl)负责构造请求、签名、发起HTTP调用
- 使用RestTemplate或WebClient发送POST请求,响应需统一解析为SmsResult对象
- 敏感信息(AppKey、Secret、签名)通过配置中心或环境变量注入,禁止写死
统一消息门面:MessageSender抽象层
业务代码不应感知是发邮件还是发短信,应面向接口编程。引入策略模式+工厂模式,按消息类型动态选择通道。
立即学习“Java免费学习笔记(深入)”;
- 定义Message基类(含type、to、content、templateId等字段)
- 定义MessageSender
泛型接口,各通道实现对应子类 - 通过@Qualifier或自定义MessageSenderFactory根据message.getType()获取具体发送器
- 支持扩展:新增钉钉机器人、企业微信、站内信等只需新增实现类,无需修改已有业务代码
异步与可靠性保障
消息发送属于典型I/O密集型操作,必须异步执行;同时要考虑失败重试、日志追踪、状态回调等生产级能力。
- 使用@Async或CompletableFuture将发送逻辑移出主流程
- 记录发送日志(时间、目标、渠道、结果、错误堆栈),便于排查和审计
- 关键通知(如登录验证码、支付结果)建议加入本地消息表+定时任务补偿机制,避免因网络抖动丢失
- 可集成RocketMQ/Kafka作为消息中间件,实现最终一致性,适合高并发场景










