refactor(common-mail): 使用 MailBuilder 替代 MailUtils

- 新增链式 MailBuilder,统一邮件发送入口
  - 删除 MailUtils,业务代码全部切换为 builder 调用
  - 默认邮件账户改为发送时获取,避免类加载阶段依赖 Bean
  - 自定义发件账号时复制默认配置,避免污染全局 MailAccount
  - 增加收件人、标题和正文参数校验
  - 调整内联图片流关闭时机,发送结束后统一关闭
  - 将 MailAccount 构建逻辑下沉到 MailProperties
This commit is contained in:
疯狂的狮子Li
2026-05-16 14:25:34 +08:00
parent f4b4c710c5
commit 99db6dceea
7 changed files with 382 additions and 494 deletions
@@ -17,7 +17,7 @@ import org.dromara.common.core.utils.SpringUtils;
import org.dromara.common.core.utils.StringUtils;
import org.dromara.common.core.utils.regex.RegexValidator;
import org.dromara.common.mail.config.properties.MailProperties;
import org.dromara.common.mail.utils.MailUtils;
import org.dromara.common.mail.core.MailBuilder;
import org.dromara.common.redis.annotation.RateLimiter;
import org.dromara.common.redis.enums.LimitType;
import org.dromara.common.redis.utils.RedisUtils;
@@ -109,7 +109,11 @@ public class CaptchaController {
String code = RandomUtil.randomNumbers(4);
RedisUtils.setCacheObject(key, code, Duration.ofMinutes(Constants.CAPTCHA_EXPIRATION));
try {
MailUtils.sendText(email, "登录验证码", "您本次验证码为:" + code + ",有效性为" + Constants.CAPTCHA_EXPIRATION + "分钟,请尽快填写。");
MailBuilder.of()
.to(email)
.subject("登录验证码")
.text("您本次验证码为:" + code + ",有效性为" + Constants.CAPTCHA_EXPIRATION + "分钟,请尽快填写。")
.send();
} catch (Exception e) {
log.error("验证码短信发送异常 => {}", e.getMessage());
throw new ServiceException(e.getMessage());