当前位置:首页 > 文章列表 > 文章 > java教程 > 手把手教你用JavaMail发邮件,超简单,一看就会!

手把手教你用JavaMail发邮件,超简单,一看就会!

2025-06-17 23:48:44 0浏览 收藏

还在为Java程序发送邮件烦恼吗?本文手把手教你如何使用JavaMail,让你轻松配置并发送邮件。JavaMail作为Java程序中强大的邮件发送工具,通过`Session`和`Message`对象,可以实现各种邮件需求。本文详细讲解了如何添加Maven或Gradle依赖,配置SMTP服务器地址、端口、认证方式及TLS加密等关键步骤。同时,针对常见的`AuthenticationFailedException`、`NoSuchProviderException`和中文乱码问题,提供了详细的解决方案。更进一步,介绍了如何在Spring Boot项目中集成JavaMail,简化配置流程,让你快速掌握JavaMail的使用技巧,提升开发效率。无论你是新手还是有经验的开发者,都能从中受益。

JavaMail是Java程序中用于发送邮件的工具,它通过Session对象和Message对象实现邮件发送。1.添加依赖:Maven项目在pom.xml中引入com.sun.mail:javax.mail:1.6.2,Gradle项目在build.gradle中添加implementation依赖。2.配置Session:设置SMTP服务器地址、端口、认证方式及TLS加密,并通过Authenticator提供邮箱账号和密码。3.创建Message:使用MimeMessage设置发件人、收件人、主题和内容;如需HTML邮件,用setContent方法指定text/html类型;如需附件,则通过Multipart组合正文与附件。4.发送邮件:调用Transport.send(message)完成发送。常见问题处理包括:AuthenticationFailedException需检查账号密码或SMTP服务是否开启;NoSuchProviderException需确认JavaMail版本和依赖完整性;中文乱码则应在setContent时指定charset=utf-8并确保代码文件编码一致。Spring Boot集成步骤为:1.添加spring-boot-starter-mail依赖;2.在application.properties或yml中配置邮件服务器属性;3.注入JavaMailSender并使用SimpleMailMessage或MimeMessageHelper构建并发送邮件。

Java中JavaMail的用法 详解邮件发送的配置步骤

JavaMail,简单来说,就是Java程序用来发邮件的工具。它提供了一套API,让你可以在代码里轻松地配置和发送各种类型的邮件,包括带附件的、HTML格式的等等。配置步骤其实并不复杂,但涉及到一些细节,比如认证、协议选择,搞清楚了就能避免很多坑。

Java中JavaMail的用法 详解邮件发送的配置步骤

解决方案

Java中JavaMail的用法 详解邮件发送的配置步骤

JavaMail的核心在于Session对象和Message对象。Session对象代表一个邮件会话,你需要配置邮件服务器的连接信息,比如SMTP服务器地址、端口、用户名和密码。Message对象则代表你要发送的邮件,包括收件人、发件人、主题和内容。

Java中JavaMail的用法 详解邮件发送的配置步骤
  1. 添加JavaMail依赖:

    首先,你需要将JavaMail的依赖添加到你的项目中。如果你使用Maven,可以在pom.xml文件中添加以下依赖:

    <dependency>
        <groupId>com.sun.mail</groupId>
        <artifactId>javax.mail</artifactId>
        <version>1.6.2</version>
    </dependency>

    如果你使用Gradle,可以在build.gradle文件中添加以下依赖:

    dependencies {
        implementation 'com.sun.mail:javax.mail:1.6.2'
    }
  2. 配置邮件会话(Session):

    创建Session对象是第一步,你需要设置一些属性来配置邮件服务器的连接。

    import javax.mail.*;
    import javax.mail.internet.*;
    import java.util.Properties;
    
    public class EmailSender {
    
        public static void main(String[] args) {
            // 配置邮件服务器属性
            Properties props = new Properties();
            props.put("mail.smtp.host", "smtp.example.com"); // SMTP服务器地址
            props.put("mail.smtp.port", "587"); // SMTP端口号,通常是587或465
            props.put("mail.smtp.auth", "true"); // 开启认证
            props.put("mail.smtp.starttls.enable", "true"); // 使用TLS加密
    
            // 创建Session对象
            Session session = Session.getInstance(props, new Authenticator() {
                protected PasswordAuthentication getPasswordAuthentication() {
                    return new PasswordAuthentication("your_email@example.com", "your_password"); // 邮箱账号和密码
                }
            });
    
            try {
                // 创建MimeMessage对象
                Message message = new MimeMessage(session);
                message.setFrom(new InternetAddress("your_email@example.com")); // 发件人邮箱
                message.setRecipients(Message.RecipientType.TO, InternetAddress.parse("recipient@example.com")); // 收件人邮箱
                message.setSubject("JavaMail测试邮件"); // 邮件主题
                message.setText("这是一封JavaMail发送的测试邮件!"); // 邮件内容
    
                // 发送邮件
                Transport.send(message);
    
                System.out.println("邮件发送成功!");
    
            } catch (MessagingException e) {
                e.printStackTrace();
            }
        }
    }

    这里需要注意的是,mail.smtp.starttls.enable属性用于启用TLS加密,这对于保护你的密码非常重要。有些邮件服务器可能需要SSL加密,这时你需要使用mail.smtp.ssl.enable属性。

  3. 创建邮件消息(Message):

    创建Message对象,设置发件人、收件人、主题和内容。

    Message message = new MimeMessage(session);
    message.setFrom(new InternetAddress("your_email@example.com"));
    message.setRecipients(Message.RecipientType.TO, InternetAddress.parse("recipient@example.com"));
    message.setSubject("JavaMail测试邮件");
    message.setText("这是一封JavaMail发送的测试邮件!");
  4. 发送邮件:

    使用Transport.send(message)方法发送邮件。

    Transport.send(message);

    如果你的代码运行后抛出AuthenticationFailedException,那很可能是你的邮箱账号或密码不正确,或者你没有开启SMTP服务。

  5. 发送HTML邮件:

    如果你想发送HTML格式的邮件,可以使用setContent方法,并指定MIME类型为text/html

    message.setContent("<h1>这是一封HTML格式的邮件!</h1><p>JavaMail真好用!</p>", "text/html; charset=utf-8");
  6. 发送带附件的邮件:

    发送带附件的邮件稍微复杂一些,你需要使用Multipart对象来组合邮件内容和附件。

    MimeMessage message = new MimeMessage(session);
    message.setFrom(new InternetAddress("your_email@example.com"));
    message.setRecipients(Message.RecipientType.TO, InternetAddress.parse("recipient@example.com"));
    message.setSubject("JavaMail带附件的邮件");
    
    // 创建Multipart对象
    Multipart multipart = new MimeMultipart();
    
    // 创建邮件正文
    MimeBodyPart textPart = new MimeBodyPart();
    textPart.setContent("这是一封带附件的邮件!", "text/html; charset=utf-8");
    multipart.addBodyPart(textPart);
    
    // 创建附件
    MimeBodyPart attachmentPart = new MimeBodyPart();
    DataSource source = new FileDataSource("path/to/your/attachment.pdf"); // 附件路径
    attachmentPart.setDataHandler(new DataHandler(source));
    attachmentPart.setFileName("attachment.pdf"); // 附件名称
    multipart.addBodyPart(attachmentPart);
    
    message.setContent(multipart);
    
    Transport.send(message);

JavaMail 常见异常如何处理?

常见的异常包括MessagingExceptionAuthenticationFailedExceptionNoSuchProviderException等。MessagingException是所有邮件异常的基类,你需要根据具体的错误信息来判断问题所在。AuthenticationFailedException通常是由于认证失败引起的,你需要检查你的邮箱账号和密码是否正确,以及是否开启了SMTP服务。NoSuchProviderException表示找不到指定的协议提供者,这可能是由于你的JavaMail版本过低或者缺少相关的依赖库引起的。

如何解决 JavaMail 发送邮件时中文乱码问题?

中文乱码问题通常是由于字符编码不一致引起的。你需要在设置邮件内容时,指定字符编码为utf-8。例如:

message.setContent("<h1>这是一封HTML格式的邮件!</h1><p>JavaMail真好用!</p>", "text/html; charset=utf-8");

另外,你还需要确保你的代码文件的字符编码也是utf-8

JavaMail 如何集成 Spring Boot?

Spring Boot 提供了对 JavaMail 的自动配置,你可以通过简单的配置就可以在 Spring Boot 项目中使用 JavaMail。

  1. 添加依赖:

    pom.xml文件中添加以下依赖:

    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-mail</artifactId>
    </dependency>
  2. 配置邮件服务器属性:

    application.propertiesapplication.yml文件中配置邮件服务器属性:

    spring.mail.host=smtp.example.com
    spring.mail.port=587
    spring.mail.username=your_email@example.com
    spring.mail.password=your_password
    spring.mail.properties.mail.smtp.auth=true
    spring.mail.properties.mail.smtp.starttls.enable=true
  3. 使用 JavaMailSender 发送邮件:

    在你的代码中注入JavaMailSender对象,然后使用它来发送邮件。

    import org.springframework.beans.factory.annotation.Autowired;
    import org.springframework.mail.SimpleMailMessage;
    import org.springframework.mail.javamail.JavaMailSender;
    import org.springframework.stereotype.Service;
    
    @Service
    public class EmailService {
    
        @Autowired
        private JavaMailSender mailSender;
    
        public void sendSimpleMessage(String to, String subject, String text) {
            SimpleMailMessage message = new SimpleMailMessage();
            message.setFrom("your_email@example.com");
            message.setTo(to);
            message.setSubject(subject);
            message.setText(text);
            mailSender.send(message);
        }
    }

    这样,你就可以在 Spring Boot 项目中轻松地使用 JavaMail 发送邮件了。

今天关于《手把手教你用JavaMail发邮件,超简单,一看就会!》的内容介绍就到此结束,如果有什么疑问或者建议,可以在golang学习网公众号下多多回复交流;文中若有不正之处,也希望回复留言以告知!

Win10怎么彻底卸载mcafee?手把手教你轻松去除Win10怎么彻底卸载mcafee?手把手教你轻松去除
上一篇
Win10怎么彻底卸载mcafee?手把手教你轻松去除
CSS中span标签是啥?手把手教你搞定span元素含义
下一篇
CSS中span标签是啥?手把手教你搞定span元素含义
查看更多
最新文章
查看更多
课程推荐
  • 前端进阶之JavaScript设计模式
    前端进阶之JavaScript设计模式
    设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
    542次学习
  • GO语言核心编程课程
    GO语言核心编程课程
    本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
    511次学习
  • 简单聊聊mysql8与网络通信
    简单聊聊mysql8与网络通信
    如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
    498次学习
  • JavaScript正则表达式基础与实战
    JavaScript正则表达式基础与实战
    在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
    487次学习
  • 从零制作响应式网站—Grid布局
    从零制作响应式网站—Grid布局
    本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
    484次学习
查看更多
AI推荐
  • 千音漫语:智能声音创作助手,AI配音、音视频翻译一站搞定!
    千音漫语
    千音漫语,北京熠声科技倾力打造的智能声音创作助手,提供AI配音、音视频翻译、语音识别、声音克隆等强大功能,助力有声书制作、视频创作、教育培训等领域,官网:https://qianyin123.com
    107次使用
  • MiniWork:智能高效AI工具平台,一站式工作学习效率解决方案
    MiniWork
    MiniWork是一款智能高效的AI工具平台,专为提升工作与学习效率而设计。整合文本处理、图像生成、营销策划及运营管理等多元AI工具,提供精准智能解决方案,让复杂工作简单高效。
    99次使用
  • NoCode (nocode.cn):零代码构建应用、网站、管理系统,降低开发门槛
    NoCode
    NoCode (nocode.cn)是领先的无代码开发平台,通过拖放、AI对话等简单操作,助您快速创建各类应用、网站与管理系统。无需编程知识,轻松实现个人生活、商业经营、企业管理多场景需求,大幅降低开发门槛,高效低成本。
    119次使用
  • 达医智影:阿里巴巴达摩院医疗AI影像早筛平台,CT一扫多筛癌症急慢病
    达医智影
    达医智影,阿里巴巴达摩院医疗AI创新力作。全球率先利用平扫CT实现“一扫多筛”,仅一次CT扫描即可高效识别多种癌症、急症及慢病,为疾病早期发现提供智能、精准的AI影像早筛解决方案。
    111次使用
  • 智慧芽Eureka:更懂技术创新的AI Agent平台,助力研发效率飞跃
    智慧芽Eureka
    智慧芽Eureka,专为技术创新打造的AI Agent平台。深度理解专利、研发、生物医药、材料、科创等复杂场景,通过专家级AI Agent精准执行任务,智能化工作流解放70%生产力,让您专注核心创新。
    116次使用
微信登录更方便
  • 密码登录
  • 注册账号
登录即同意 用户协议隐私政策
返回登录
  • 重置密码