云服务器特惠 99/年起
  1. 腾讯云优惠网首页
  2. 腾讯云产品

邮件推送 Java 调用示例

• 腾讯云产品

这篇提供腾讯云邮件推送SMTP服务的Java代码示例（JDK 1.8），演示如何通过465端口（隐式TLS）发送普通邮件和带附件的邮件，并列出支持的SSL协议与加密套件。 – 发送邮件: 配置smtp.qcloudmail.com及465端口，使用smtps协议认证，设置发件人、收件人及邮件内容。 – 发送附件: 通过MimeMultipart添加文本和附件，附件总大小不超过10M，需处理中文文件名编码。 – 常见问。

相关产品
邮件推送 产品页，含版本规格、价格与购买入口。

以下代码示例，是 Demo 使用 JDK 1.8：

一、注意事项

1. 目前服务端支持的 ssl 协议和加密套件如下，请选择合适的 ssl 版本：

ssl_protocols TLSv1 TLSv1.1 TLSv1.2 TLSv1.3;ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384:DHE-RSA-CHACHA20-POLY1305:ECDHE-ECDSA-AES128-SHA256:ECDHE-RSA-AES128-SHA256:ECDHE-ECDSA-AES128-SHA:ECDHE-RSA-AES128-SHA:ECDHE-ECDSA-AES256-SHA384:ECDHE-RSA-AES256-SHA384:ECDHE-ECDSA-AES256-SHA:ECDHE-RSA-AES256-SHA:DHE-RSA-AES128-SHA256:DHE-RSA-AES256-SHA256:AES128-GCM-SHA256:AES256-GCM-SHA384:AES128-SHA256:AES256-SHA256:AES128-SHA:AES256-SHA:DES-CBC3-SHA:RC4-MD5:RC4-SHA;

2. 服务地址和端口请参见 SMTP 服务地址。

以下是代码示例：

package org.example;import javax.mail.*;import javax.mail.internet.InternetAddress;import javax.mail.internet.MimeMessage;import java.io.UnsupportedEncodingException;import java.nio.charset.StandardCharsets;import java.util.Properties;public class SampleMail { private static final String SMTP_HOST = "smtp.qcloudmail.com"; private static final String SMTP_PORT = "465"; public static void main(String[] args) { // 配置发送邮件的环境属性 final Properties props = new Properties(); props.put("mail.transport.protocol", "smtps"); // smtps表示隐式TLS，对应465端口。否则为587端口，显示TLS // 表示SMTP发送邮件，需要进行身份验证 props.put("mail.smtp.auth", "true"); props.put("mail.smtp.host", SMTP_HOST); // 如果使用ssl，则去掉使用25端口的配置，进行如下配置, props.put("mail.smtp.socketFactory.class", "javax.net.ssl.SSLSocketFactory"); props.put("mail.smtp.socketFactory.port", SMTP_PORT); props.put("mail.smtp.port", SMTP_PORT); // 发件人的账号，填写控制台配置的发信地址,比如xxx@xxx.com props.put("mail.user", "xxx@xxx.com"); // 访问SMTP服务时需要提供的密码(在控制台选择发信地址进行设置) props.put("mail.password", "XXXX"); props.setProperty("mail.smtp.socketFactory.fallback", "false"); props.put("mail.smtp.ssl.enable", "true"); //props.put("mail.smtp.starttls.enable","true"); // 构建授权信息，用于进行SMTP进行身份验证 Authenticator authenticator = new Authenticator() { @Override protected PasswordAuthentication getPasswordAuthentication() { // 用户名、密码 String userName = props.getProperty("mail.user"); String password = props.getProperty("mail.password"); return new PasswordAuthentication(userName, password); } }; // 使用环境属性和授权信息，创建邮件会话 Session mailSession = Session.getInstance(props, authenticator);// mailSession.setDebug(true); //UUID uuid = UUID.randomUUID(); //final String messageIDValue = "<" + uuid.toString() + ">"; // 创建邮件消息 MimeMessage message = new MimeMessage(mailSession) { //@Override //protected void updateMessageID() throws MessagingException { //设置自定义Message-ID值 //setHeader("Message-ID", messageIDValue); //} }; try { // 设置发件人邮件地址和名称。填写控制台配置的发信地址,比如xxx@xxx.com。和上面的mail.user保持一致。名称用户可以自定义填写。 InternetAddress from = new InternetAddress("xxx@xxx.com", "test"); message.setFrom(from); //可选。设置回信地址// Address[] a = new Address[1];// a[0] = new InternetAddress("***");// message.setReplyTo(a); // 设置收件人邮件地址，比如yyy@yyy.com InternetAddress to = new InternetAddress("xxx@xxx.com"); message.setRecipient(MimeMessage.RecipientType.TO, to); //如果同时发给多人，才将上面两行替换为如下（因为部分收信系统的一些限制，尽量每次投递给一个人；同时我们限制单次允许发送的人数是50人）： //InternetAddress[] adds = new InternetAddress[2]; //adds[0] = new InternetAddress("xxx@xxx.com"); //adds[1] = new InternetAddress("xxx@xxx.com"); //message.setRecipients(Message.RecipientType.TO, adds); // 设置邮件标题 message.setSubject("测试邮件"); message.setHeader("Content-Transfer-Encoding", "base64"); // 设置邮件的内容体 type: text/plain（纯文本）text/html（HTML 文档） message.setContent("<!DOCTYPE html>\\n<html>\\n<head>\\n<meta charset=\\"utf-8\\">\\n<title>hello world</title>\\n</head>\\n<body>\\n " + "<h1>我的第一个标题</h1>\\n <p>我的第一个段落。</p>\\n</body>\\n</html>", "text/html;charset=UTF-8"); //发送邮件 Transport.send(message); } catch (MessagingException | UnsupportedEncodingException e) { String err = e.getMessage(); err = new String(err.getBytes(StandardCharsets.ISO_8859_1), StandardCharsets.UTF_8); System.out.println(err); } }}

二、发送附件

package org.example;import javax.activation.DataHandler;import javax.activation.FileDataSource;import javax.mail.*;import javax.mail.internet.*;import java.io.UnsupportedEncodingException;import java.nio.charset.StandardCharsets;import java.util.Properties;import java.util.UUID;public class SampleMailAttach { private static final String SMTP_HOST = "smtp.qcloudmail.com"; private static final String SMTP_PORT = "465"; public static void main(String[] args) { // 配置发送邮件的环境属性 final Properties props = new Properties(); // 表示SMTP发送邮件，需要进行身份验证 props.put("mail.transport.protocol", "smtps"); // smtps表示隐式TLS，对应465端口。否则为587端口，显示TLS props.put("mail.smtp.auth", "true"); props.put("mail.smtp.host", SMTP_HOST); // 如果使用ssl，则去掉使用25端口的配置，进行如下配置, props.put("mail.smtp.socketFactory.class", "javax.net.ssl.SSLSocketFactory"); props.put("mail.smtp.socketFactory.port", SMTP_PORT); props.put("mail.smtp.port", SMTP_PORT); // 发件人的账号，填写控制台配置的发信地址,比如xxx@xxx.com props.put("mail.user", "xxx@xxx.com"); // 访问SMTP服务时需要提供的密码(在控制台选择发信地址进行设置) props.put("mail.password", "XXXX"); props.setProperty("mail.smtp.socketFactory.fallback", "false"); props.put("mail.smtp.ssl.enable", "true"); //props.put("mail.smtp.starttls.enable","true"); // 构建授权信息，用于进行SMTP进行身份验证 Authenticator authenticator = new Authenticator() { @Override protected PasswordAuthentication getPasswordAuthentication() { // 用户名、密码 String userName = props.getProperty("mail.user"); String password = props.getProperty("mail.password"); return new PasswordAuthentication(userName, password); } }; // 使用环境属性和授权信息，创建邮件会话 Session mailSession = Session.getInstance(props, authenticator); UUID uuid = UUID.randomUUID(); final String messageIDValue = "<" + uuid.toString() + ">"; //创建邮件消息 MimeMessage message = new MimeMessage(mailSession) { @Override protected void updateMessageID() throws MessagingException { //设置自定义Message-ID值 setHeader("Message-ID", messageIDValue); } }; try { // 设置发件人邮件地址和名称。填写控制台配置的发信地址,和mail.user保持一致。发信别名可以自定义，如test。 InternetAddress from = new InternetAddress("xxx@xxx.com", "test"); message.setFrom(from); //可选。设置回信地址 Address[] a = new Address[1]; a[0] = new InternetAddress("xxx@xxx.com"); message.setReplyTo(a); //设置收件人邮件地址，比如yyy@yyy.com InternetAddress to = new InternetAddress("xxx@xxx.com"); message.setRecipient(MimeMessage.RecipientType.TO, to); //如果同时发给多人，才将上面两行替换为如下（因为部分收信系统的一些限制，尽量每次投递给一个人；同时我们限制单次允许发送的人数是50人）： /*InternetAddress[] adds = new InternetAddress[2]; adds[0] = new InternetAddress("xxx@xxx.com"); adds[1] = new InternetAddress("xxx@xxx.com"); message.setRecipients(Message.RecipientType.TO, adds);*/ // 设置邮件标题 message.setSubject("测试邮件"); //发送附件，总的邮件大小不超过10M，创建消息部分 BodyPart messageBodyPart = new MimeBodyPart(); //消息 text/plain（纯文本）text/html（HTML 文档） messageBodyPart.setText("<!DOCTYPE html>\\n<html>\\n<head>\\n<meta charset=\\"utf-8\\">\\n<title>hello world</title>\\n</head>\\n<body>\\n " + "<h1>我的第一个标题</h1>\\n <p>我的第一个段落。</p>\\n</body>\\n</html>"); messageBodyPart.setHeader("Content-Type", "text/plain;charset=utf-8"); //创建多重消息 Multipart multipart = new MimeMultipart(); //设置文本消息部分 multipart.addBodyPart(messageBodyPart); //附件部分 messageBodyPart = new MimeBodyPart(); //设置要发送附件的文件路径 String filename = "/Users/aaa/bbb/a.txt"; FileDataSource source = new FileDataSource(filename); messageBodyPart.setDataHandler(new DataHandler(source)); //处理附件名称中文（附带文件路径）乱码问题 String filenameEncode = MimeUtility.encodeText(filename, "UTF-8", "base64"); messageBodyPart.setFileName(filenameEncode); messageBodyPart.setHeader("Content-Transfer-Encoding", "base64"); messageBodyPart.setHeader("Content-Disposition", "attachment"); messageBodyPart.setHeader("Content-Type", "application/octet-stream;name=\\"" + filenameEncode + "\\""); multipart.addBodyPart(messageBodyPart); //附件部分,多个附件，分为多个part BodyPart messageBodyPart1 = new MimeBodyPart(); //设置要发送附件的文件路径 String filename1 = "/Users/aaa/bbb/b.txt"; FileDataSource source1 = new FileDataSource(filename1); messageBodyPart1.setDataHandler(new DataHandler(source1)); //处理附件名称中文（附带文件路径）乱码问题 String filenameEncode1 = MimeUtility.encodeText(filename1, "UTF-8", "base64"); messageBodyPart1.setHeader("Content-Transfer-Encoding", "base64"); messageBodyPart1.setHeader("Content-Disposition", "attachment"); messageBodyPart1.setHeader("Content-Type", "application/octet-stream;name=\\"" + filenameEncode1 + "\\""); multipart.addBodyPart(messageBodyPart1); //发送含有附件的完整消息 message.setContent(multipart); //发送附件代码，结束 //发送邮件 Transport.send(message); } catch (MessagingException | UnsupportedEncodingException e) { String err = e.getMessage(); err = new String(err.getBytes(StandardCharsets.ISO_8859_1), StandardCharsets.UTF_8); System.out.println(err); } }}

三、遇到报错：“No appropriate protocol (protocol is disabled or cipher suites are inappropriate)”，如何处理？

找到 jdk/jre/lib/security/java.security 文件进行修改：

相关内容：

  1. 邮件推送 Go 调用示例 以下代码示例，Go 语言（版本为1.16）通过 SMTP 发送邮件：1. 目前服务端支持的 SSL 协议和加密套件如下，请选择适合的 SSL 版本：ssl_protocols TLSv1 TLSv1.1 TLSv1.2 TLSv1.3;ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM。...
  2. 邮件推送 PHP 调用示例 2. 目前服务端支持的 ssl 协议和加密套件如下，请选择适合的 ssl 版本ssl_protocols TLSv1 TLSv1.1 TLSv1.2 TLSv1.3;ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384。...
  3. 邮件推送 C# 调用示例 由于库对465、587端口的支持不完善，推荐使用以下示例中的第三方库 MailKit。using System;using MimeKit;using MailKit.Net.Smtp;using MailKit.Security;// This code example uses MailKit (MIT License: https://github.com/jstedfast/MailKit)class。...
  4. 全球加速2.0 TLS安全策略组 TLS（Transport Layer Security）是一种用于保障网络通信安全的加密协议，其前身是 SSL（Secure Sockets Layer）。TLS 通过加密、身份验证和数据完整性保护，确保客户端（如浏览器）与服务器之间的数据传输不被窃听或篡改。它广泛应用于 HTTPS、电子邮件、VPN 等场景，是互联网保密通信的工业标准。TLS 协议经历了多个版本的迭代，每个版本在安全性和性能上有所改进。...
  5. 内容分发网络 CDN HTTPS 回源算法说明 这篇列出了腾讯云CDN HTTPS回源支持的密码套件，涵盖ECDHE、DHE、DH、SRP、PSK等多种密钥交换算法及AES、CAMELLIA、SEED等加密算法，共约90种算法。...
  6. 邮件推送 Webhook 文档 以下代码示例，Python 语言（版本 >= 3.6即可）通过 SMTP 发送邮件，具体示例如下：# -*- coding:utf-8 -*-import smtplibimport sslfrom email.header import Headerfrom email.mime.multipart import MIMEMultipartfrom email.mime.text import MIMETextfr。...
  7. Web 应用防火墙 使用相关 访问日志功能用于记录 Web 应用防火墙防护域名的访问日志信息，提供防护域名在用户自定义的日志保存天数内（最大180天）的访问日志查询和下载功能。如需下载180天访问日志，请开启相关域名访问日志开关，并于控制台设置存储180天访问日志。...
  8. 边缘安全加速平台 EO TLS 版本及密码套件说明 这篇说说EdgeOne支持的TLS协议版本（1.0至1.3）与密码套件，并说明如何根据安全与兼容性需求自定义配置，默认启用所有版本及eo-loose-v2023套件。 TLS版本与密码套件：支持TLS 1.0-1.3，提供eo-loose、eo-general、eo-strict三种套件，最终支持取版本与套件交集。...
赞 (0)
上一篇 4天前
下一篇 4天前