javax.net.ssl.SSLHandshakeException：没有合适的协议。如何强制 Java 使用 TLSv1.2 发送邮件？

Question

我正在尝试使用 JavaMailSender 在 Spring Boot 中发送邮件，但出现此错误：

javax.net.ssl.SSLHandshakeException: No appropriate protocol (protocol is disabled or cipher suites are inappropriate). Failed messages: javax.mail.MessagingException: Could not convert socket to TLS;
  nested exception is:
    javax.net.ssl.SSLHandshakeException: No appropriate protocol (protocol is disabled or cipher suites are inappropriate)

阅读后发现是因为我们使用的 TLSv1 或 TLSv1.1 已经过时了，我们应该使用 v1.2 或更高版本。我尝试在 application.yml 中添加值为 TLSv1.2 的 ssl.protocols 属性，但它似乎不起作用。这是我的 application.yml：

spring:
  mail:
    host: smtp.gmail.com
    port: 587
    username: ******@gmail.com
    password: *******
    protocol: smtp
    tls: true
    properties.mail.smtp:
      auth: true
      ssl.trust: smtp.gmail.com
      starttls.required: true
      starttls.enabled: true
      ssl.protocols: TLSv1.2

这是发送邮件的方法：

public void sendEmail(String to, String subject, String body) {
    logger.info("Sending mail to : " + to);
    SimpleMailMessage mail = new SimpleMailMessage();
    mail.setTo(to);
    mail.setSubject(subject);
    mail.setText(body);

    try {
        javaMailSender.send(mail);
        logger.info("Mail sent to " + to);
    } catch (Exception e) {
        logger.error("Could not send mail to " + to + ". Exception : " + e.getMessage());
    }
}

我更新了 JavaMailSender 版本，但没有解决问题。唯一可行的方法是按照this answer 中的建议从 jdk.tls.disabledAlgorithms 中删除 TLSv1 和 TLSv1.1，但这只是一个临时修复。如何让邮件发件人使用 TLSv1.2 或更高版本？我在 application.yml 中定义 ssl.protocols 属性的方式有什么问题吗？

这是我使用的java版本：

openjdk version "1.8.0_292"
OpenJDK Runtime Environment (AdoptOpenJDK)(build 1.8.0_292-b10)
OpenJDK 64-Bit Server VM (AdoptOpenJDK)(build 25.292-b10, mixed mode)

以及spring boot starter邮件版：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-mail</artifactId>
    <version>2.5.3</version>
</dependency>

Answer 1

我最近回答了一个几乎相同的question。

如您所料，您的问题将与 JDK 中引入的 a change 有关，以便默认禁用不安全的 TLS 协议版本：

安全库/javax.net.ssl
➜ 禁用 TLS 1.0 和 1.1

TLS 1.0 和 1.1 是 TLS 协议的版本，它们不再是 被认为是安全的，并已被更安全和现代的取代 版本（TLS 1.2 和 1.3）。

这些版本现已默认禁用。如果遇到 问题，您可以自担风险，通过删除重新启用版本 jdk.tls.disabledAlgorithms 中的“TLSv1”和/或“TLSv1.1” java.security 配置文件中的安全属性。

正如您在bug description 中看到的那样，更改已向后移植到不同的 JDK 版本，即您正在使用的版本。

为了解决这个问题，您可以编辑您的java.security 配置文件并从jdk.tls.disabledAlgorithms 安全属性中删除TLSv1 和/或TLSv1.1。

此外，您可以在配置属性中明确包含所需的 TLS 协议：

props.put("mail.smtp.ssl.protocols", "TLSv1.2");

老实说，我不明白为什么 Spring Boot 不应用此配置，看来您定义正确。您可以在描述mail properties configuration 和不同的accepted mail properties 时查看库的源代码，以及Spring Boot documentation 中的描述。请尝试像这样定义属性：

spring:
  mail:
    properties:
      # other properties you need
      "mail.smtp.ssl.protocols": "TLSv1.2"

为了排除一些可能与 YAML 格式有关的问题，您可以尝试在 JavaMaiSenderImpl 中显式设置此属性，仅用于测试：

public void sendEmail(String to, String subject, String body) {
    logger.info("Sending mail to : " + to);
    SimpleMailMessage mail = new SimpleMailMessage();
    mail.setTo(to);
    mail.setSubject(subject);
    mail.setText(body);

    try {
        // Just for validating the solution
        JavaMailSenderImpl javaMailSenderImpl = (JavaMailSenderImpl)javaMailSender;
        // Please, put a breakpoint here and debug the configured
        // properties, it will provide you a valuable information
        // about the actual properties that have been applied      
javaMailSenderImpl.getJavaMailProperties().put("mail.smtp.ssl.protocols", "TLSv1.2");

        javaMailSender.send(mail);
        logger.info("Mail sent to " + to);
    } catch (Exception e) {
        logger.error("Could not send mail to " + to + ". Exception : " + e.getMessage());
    }
}

Answer 2

我在使用 application.properties 时遇到了类似的问题 我得到的错误是：

-dev.miku.r2dbc.mysql.client.MySqlConnectionClosedException：连接意外关闭 -d.m.r.mysql.client.ReactorNettyClient：错误：没有合适的协议（协议被禁用或密码套件不合适） -12-16 14:48:30.287 WARN 27232 --- [actor-tcp-nio-2] d.m.r.mysql.client.ReactorNettyClient：连接已被对等方关闭 2021-12-16 14:48:30.288 错误 27232 --- [actor-tcp-nio-2] reactor.core.publisher.Operators ：操作员称为默认 onErrorDropped

这是我的解决方案：

一行代码就解决了这个问题：

spring.r2dbc.properties.ssl= false

Answer 3

您可以通过设置System.setProperty("mail.smtp.ssl.protocols", protocols); 来实现。例如：

String protocols = String.join(" ", 
    SSLContext
        .getDefault()
        .getSupportedSSLParameters()
        .getProtocols()
);

System.setProperty("mail.smtp.ssl.protocols", protocols);

无论如何，此配置无需任何配置即可工作

  mail:
    host: smtp.gmail.com
    port: 587
    username: ***@gmail.com
    password: P4ssw0rd
    properties:
      mail:
        smtp:
          starttls:
            enable: true
            required: true
      auth: true