Springboot+Javamail實作郵件發送
使用的是spring-context-support-5.2.6.RELEASE.jar裡的javamail
javamail 官方文檔：javamail
代碼在：gitee
官方代碼介紹
Sample code for an HTML mail with an inline image and a PDF attachment:
帶有圖像和PDF附件的HTML郵件的示例代碼：
mailSender.send(new MimeMessagePreparator() {
public void prepare(MimeMessage mimeMessage) throws MessagingException {
MimeMessageHelper message = new MimeMessageHelper(mimeMessage, true, "UTF-8");
message.setFrom("[email protected]");
message.setTo("[email protected]");
message.setSubject("my subject");
message.setText("my text <img src='cid:myLogo'>", true);
message.addInline("myLogo", new ClassPathResource("img/mylogo.gif"));
message.addAttachment("myDocument.pdf", new ClassPathResource("doc/myDocument.pdf"));
}
});
MimeMessageHelper參數說明
- from（發件人）
- to（收件人）
- subject（郵件主題）
- text（内容）
- inline（内嵌圖檔或者圖檔附件）
- attachment（附件）
- cc（抄送人）
- bcc（密送人）
Springboot 代碼示例
開啟POP3/SMTP服務，并拿到授權碼
首先登入163郵箱 開啟POP3/SMTP服務
拿到授權碼
application.yml配置檔案不要填郵箱密碼，要填授權碼，不然會報錯：535 Error: authentication failed
application.yml配置檔案
spring:
mail:
default-encoding: UTF-8
host: smtp.163.com
username: [email protected]
# 不要填郵箱密碼，要填授權碼，不然會報錯：535 Error: authentication failed
password:
protocol: smtp
properties:
mail:
smtp:
auth: true
port: 994 #465或者994
starttls:
enable: true
required: true
ssl:
enable: true
display:
sendmail: Javen
sendname: Spring Boot Guide Email
MailDetail（參數封裝）
記得setter、getter
public class MailDetail {
/**
* 發件人名稱
*/
private String senderName;
/**
* 發件人郵件位址
*/
private String senderMail;
/**
* 收件人位址
*/
private String addresseeMail;
/**
* 郵件标題
*/
private String mailTitle;
/**
* 抄送人
*/
private String[] cc;
/**
* 郵件内容
*/
private String content;
/**
* true内容為HTML，false内容為文本 預設文本
*/
private Boolean html = false;
}
發送郵件Service層
@Service
public class MailServiceImpl implements MailService {
private static final Logger log = LoggerFactory.getLogger(MailServiceImpl.class);
private final JavaMailSender javaMailSender;
@Autowired
public MailServiceImpl(JavaMailSender javaMailSender) {
this.javaMailSender = javaMailSender;
}
@Override
public boolean sendMessage(MailDetail detail) {
log.info("mailServiceImpl.sendMessage.request:{}", new Gson().toJson(detail));
try {
MimeMessage message = javaMailSender.createMimeMessage();
MimeMessageHelper messageHelper = new MimeMessageHelper(message, true);
// 發件人位址
InternetAddress fromAddress = new InternetAddress(MimeUtility.encodeText(detail.getSenderName()) + "<" + detail.getSenderMail() + ">");
messageHelper.setFrom(fromAddress);
// 收件人位址
InternetAddress toAddress = new InternetAddress(MimeUtility.encodeText(detail.getAddresseeMail()) + "<" + detail.getAddresseeMail() + ">");
messageHelper.setTo(toAddress);
// 郵件名稱
messageHelper.setSubject(detail.getMailTitle());
// 第二個參數指定發送的是HTML格式
messageHelper.setText(detail.getContent(), detail.getHtml());
// 抄送人
if (detail.getCc() != null && detail.getCc().length > 0) {
messageHelper.setCc(detail.getCc());
}
// 測試圖檔附件（ClassPathResource要把圖檔放到resources，并且編譯代碼把圖檔加載到target裡）
// messageHelper.addInline("myLogo", new ClassPathResource("WechatIMG2602.jpeg"));
javaMailSender.send(message);
return true;
} catch (MessagingException | UnsupportedEncodingException e) {
log.error("mailServiceImpl.sendMessage.error:{},{}", e.getMessage(), e.getStackTrace());
}
return false;
}
}
發送郵件Controller層
主要controller實作類ApplicationRunner 的run 項目啟動則執行
@RestController
public class MailController implements ApplicationRunner {
private static final Logger log = LoggerFactory.getLogger(MailController.class);
protected final MailService mailService;
@Autowired
public MailController(MailService mailService) {
this.mailService = mailService;
}
@Override
public void run(ApplicationArguments args) throws Exception {
log.info("syncController.run");
MailDetail mailDetail = new MailDetail();
// 發件人名稱
mailDetail.setSenderName("雲深小麥");
// 發件人郵箱
mailDetail.setSenderMail("[email protected]");
// 郵件名稱
mailDetail.setMailTitle("這裡是測試");
// 收件人郵箱
mailDetail.setAddresseeMail("[email protected]");
// 發送純文字 setHtml(false) 預設false
// mailDetail.setContent("你好！我是雲深小麥");
// 發送HTML setHtml(true)
mailDetail.setContent("<html><head></head><body><h1>你好！我是雲深小麥</h1></body></html>");
// 内容是否為HTML
mailDetail.setHtml(true);
boolean b = mailService.sendMessage(mailDetail);
if (b) {
log.info("發送成功");
}
}
}
結果
一些問題
535 Error: authentication failed
Caused by: javax.mail.AuthenticationFailedException: 535 Error: authentication failed
調用163郵箱伺服器來發送郵件,我們需要開啟POP3/SMTP服務,這時163郵件會讓我們設定用戶端授權碼，這個授權碼替代上面代碼部分的passwd即可成功發送郵件
如何重置授權碼
550 Invalid User
com.sun.mail.smtp.SMTPSenderFailedException: 550 Invalid User
該錯誤表示：收件位址為無效帳号。
建議：
1，請檢查收件人位址是否存在文法錯誤，例如說有攜帶多餘的标點符号。位址與位址之間的分隔号是英文字元下的分号。
2，請檢查收件人位址是否有錯誤，收件人不存在等情況。
3，請檢查發件人在系統的狀态，是否被删除、禁用或者當機狀态。