Java实现发送邮件（含个人和企业邮箱，以及可能遇到的报错等完整讲述）

这里给出完整的发送邮箱的代码，可直接使用2、完整代码。这里也给出了一些报错的解决方案。

---

目录

1、了解SMTP协议

2、完整代码

2.1导入依赖

2.2配置文件中配置基础信息：

2.3工具类MailUtil

2.4Controller接口

3、企业邮箱的配置

4、发送邮箱报错

4.1使用企业邮箱的情况报错

 4.2报错：501 mail from address must be same as authorization user

---

1、了解SMTP协议

这里我们是发送邮件，所以使用SMTP协议。

1.1简单了解涉及的两个传输协议

SMTP协议：

发送邮件： 我们通常把处理用户smtp请求(邮件发送请求)的服务器称之为SMTP服务器(邮件发送服务器)。

POP3协议：

接收邮件： 我们通常把处理用户pop3请求(邮件接收请求)的服务器称之为POP3服务器(邮件接收服务器)。

1.2获取qq邮箱授权码步骤

（这里是 个人邮箱 获取授权码的方式）企业邮箱在后面3、企业邮箱的配置

步骤2做完之后，下滑页面，就可以看到步骤3、4

 

2、完整代码

2.1导入依赖

<!--发送邮件-->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-mail</artifactId>
</dependency>

这里也有用到hutool包，也可以顺便导入进去

<!-- hutool工具类 版本：<hutool.version>5.3.8</hutool.version> --> 
 
<dependency>
   <groupId>cn.hutool</groupId>
   <artifactId>hutool-core</artifactId>
   <version>5.3.8</version>
</dependency>
<dependency>
   <groupId>cn.hutool</groupId>
   <artifactId>hutool-crypto</artifactId>
   <version>5.3.8</version>
</dependency>
 
<dependency>
   <groupId>cn.hutool</groupId>
   <artifactId>hutool-extra</artifactId>
   <version>5.3.8</version>
</dependency>
<dependency>
   <groupId>cn.hutool</groupId>
   <artifactId>hutool-http</artifactId>
   <version>5.3.8</version>
</dependency>

2.2配置文件中配置基础信息：

spring:
  mail:
# SMTP服务器的地址，这是QQ的，其他的邮箱要改一下

#    企业使用  smtp.exmail.qq.com
#    host: smtp.exmail.qq.com
#    username: 邮箱地址
#    password: 前面获取的授权码

#    个人使用：  smtp.qq.com
    host: smtp.qq.com
    username: 发送人的邮件地址，这里有坑，不能使用邮箱名字，使用邮箱地址
    password: 前面获取的授权码
    receiver: 接收人的邮件地址

# 设置是否需要认证，如果为true,那么用户名和密码就必须的，
# 如果设置false，可以不设置用户名和密码，当然也得看你的对接的平台是否支持无密码进行访问的。
    properties:
      mail:
        smtp:
          auth: true
# STARTTLS 是对纯文本通信协议的扩展。它提供一种方式将纯文本连接升级为加密连接（TLS或SSL），而不是另外使用一个端口作加密通信。
          starttls:
            enable: true
            required: true
    default-encoding: UTF-8

2.3工具类MailUtil

创建SpringBean对象

import lombok.Data;
import java.io.Serializable;

@Data
public class Mail implements Serializable {
    private static final long serialVersionUID = 1L;
    private String recipient ;//邮件接收人
    private String subject; //邮件主题（标题）
    private String content; //邮件内容
}

@Component
@Slf4j
public class MailUtil {
    @Value("${spring.mail.username}")
    private String sender; //邮件发送者

    @Resource
    private JavaMailSender javaMailSender;


    /**
     * 发送纯文本邮件
     *
     * @param mail
     */
    public void sendSimpleMail(Mail mail) throws BusinessException {
        try {
            SimpleMailMessage mailMessage = new SimpleMailMessage();
            mailMessage.setFrom(sender); //邮件发送者
            mailMessage.setTo(mail.getRecipient()); // 邮件发给的人
            mailMessage.setSubject(mail.getSubject());  // 邮件主题
            mailMessage.setText(mail.getContent());  // 邮件内容

            javaMailSender.send(mailMessage);
            log.info("邮件发送成功 收件人：{}", mail.getRecipient());
        } catch (Exception e) {
            log.error("邮件发送失败 {}", e.getMessage());
            throw new BusinessException("邮件发送异常"); //这是我自定义的一个异常码
        }
    }

    /**
     * 复杂邮件
     * 可附带各种文件的邮件
     *
     * @param mail
     */
    public void sendWordMessageWord(Mail mail) throws MessagingException {
        //复杂邮件
        MimeMessage mimeMessage = javaMailSender.createMimeMessage();
//true表示需要创建一个multipart message
        MimeMessageHelper messageHelper = new MimeMessageHelper(mimeMessage, true);
        messageHelper.setFrom(sender);
        messageHelper.setTo(mail.getRecipient());
        messageHelper.setSubject("这个可以理解为邮件的标题");
        messageHelper.setText("这里就是一个邮件内容主体信息");
        String filePath = "E:\\demo\\个人简历.docx";
        //这里需要给出文件的绝对路径
        FileSystemResource file = new FileSystemResource(new File(filePath));
        String fileName = file.getFilename();
        messageHelper.addAttachment(fileName, file);

        javaMailSender.send(mimeMessage);
    }
}

2.4Controller接口

@RestController
@Slf4j
public class MailContraller {
   
   //三种方式选择邮件接收者


    //接收人
    private static String recipient = "xxxxxxxxxx@qq.com";

    //这里使用配置文件配置的邮件接收者
    @Value("${spring.mail.receiver}")
    private String receiver; //邮件接收者

    @Resource
    private  MailUtil mailUtil;

/**
 * 普通纯文本邮件
 */
    @GetMapping(value = "/mailDemo")
    public Result<?> sendMailDemo(@RequestParam("写你的接收者") String "写你的接收者") throws BusinessException {

       // recipient = reception;

        Mail mail = new Mail();
        int code = (int) ((Math.random() * 9 + 1) * 100000);

        //这里配置接收者，可以从接口参数中获取，也可以提前配置
        mail.setRecipient("这里写接收的邮箱即可");

        // mail.setRecipient("recipient");

        mail.setSubject("修改邮箱");
        mail.setContent("亲爱的用户：您好！\n" +
                "\n" + "    您收到这封电子邮件是因为您 (也可能是某人冒充您的名义) 申请了修改邮箱。假如这不是您本人所申请, 请不用理会这封电子邮件, 但是如果您持续收到这类的信件骚扰, 请您尽快联络管理员。\n" +
                "\n" +
                "   请使用以下验证码完成后续修改邮箱流程\n" + "\n  " +
                code + "\n\n" + "  注意：请您收到邮件的十分钟内（" +
                DateFormatUtils.format(new Date().getTime() + 10 * 60 * 1000, "yyyy-MM-dd HH:mm:ss") +
                "）前使用，否则验证码将会失效。"
        );
        mailUtil.sendSimpleMail(mail);
        return Result.OK();
    }

/**
 * 带有附件邮件
 */
    @GetMapping(value = "/wordMailDemo")
    public Result<?> sendWordMailDemo(@RequestParam(value = "reception", required = false) String reception) throws MessagingException {

        //reception 接收者的邮箱
        if (ObjectUtil.isEmpty(reception)) {
            recipient = reception;
        }

        Mail mail = new Mail();
        mail.setRecipient(recipient);
        mailUtil.sendWordMessageWord(mail);
        return Result.OK();
    }
}

到这里就可以实现发送邮件了：

3、企业邮箱的配置

        企业邮箱授权码需要管理员才可以获取，需要登录上管理员账户，再去像前面一样获取企业邮箱的授权码即可。

#需要改一下smtp地址，不过在前面写的配置文件中，我已经注释了，可以直接使用

spring.mail.host=smtp.exmail.qq.com

spring.mail.username=xxxxx@xxxx.com

#注意这里的密码可以填登录密码，不需要授权码，但如果你想用授权码登录，授权码获取参照第三条

spring.mail.password=xxxx

spring.mail.properties.mail.smtp.auth=true

spring.mail.properties.mail.smtp.starttls.enable=true

spring.mail.properties.mail.smtp.starttls.required=true

spring.mail.default-encoding=UTF-8

需要注意：

        现在很多服务器运营商都封25端口了！主要是防止垃圾邮件，不过一般是可以申请开启的。

        这是为了加强管理，因为如果大量垃圾邮件从你的平台出去，以后ip段都被人黑名单了，谁也别想发了，所以想阿里云等服务器运营商都封了25端口，所以我们项目部署到服务器的时候邮件要换成465端口发送，这里依据各自项目情况而定。

        只需要在配置文件下加上SSL配置就好，建议在本地发送的时候也加上，更加安全。

# SSL 配置
spring.mail.port=465
spring.mail.protocol=smtp
spring.mail.properties.mail.smtp.ssl.enable=true
spring.mail.properties.mail.smtp.socketFactory.port=465
spring.mail.properties.mail.smtp.socketFactory.class=javax.net.ssl.SSLSocketFactory

4、发送邮箱报错

4.1使用企业邮箱的情况报错

报错：

org.springframework.mail.MailSendException: Failed messages: com.sun.mail.smtp.SMTPSendFailedException: 550 Connection frequency limited

这里是因为使用的是企业邮箱，这个邮箱可以设置同一个IP一个时间段的请求数量来做限流。只需要使用管理员账号去修改这个设置即可。 

 4.2报错：501 mail from address must be same as authorization user

翻译：501 发件人地址必须与授权用户相同

        首先就是不能发送人和接收人是同一个人，然后这里如果检查代码没问题，就重新运行项目（热部署的不行，需要重新运行），如果还是不行，就去maven的生命周期中，先clear再install运行，然后重新运行项目即可。

        还有就是要确保接收人的邮箱是开通的才可以，不然也会报错。