使用JavaMail通过Gmail SMTP发邮件时遇TLS套接字转换异常求助

这个异常通常是配置缺失、账号权限限制或者网络问题导致的，我帮你梳理几个关键的解决步骤：

1. 完善Spring邮件发送配置 #

你的JavaMailSenderImpl配置缺少了关键的SMTP属性，必须开启TLS和身份验证，建议补充如下配置：

<bean id="mailSender" class="org.springframework.mail.javamail.JavaMailSenderImpl">
    <property name="host" value="smtp.gmail.com" />
    <property name="port" value="587" />
    <property name="username" value="your-email@gmail.com" />
    <!-- 这里要用应用专用密码，不是你的Gmail普通密码 -->
    <property name="password" value="your-app-specific-password" />
    <!-- 添加JavaMail属性配置 -->
    <property name="javaMailProperties">
        <props>
            <!-- 开启身份验证 -->
            <prop key="mail.smtp.auth">true</prop>
            <!-- 强制启用STARTTLS加密 -->
            <prop key="mail.smtp.starttls.enable">true</prop>
            <prop key="mail.smtp.starttls.required">true</prop>
            <!-- 指定支持的TLS版本，避免因版本过低被Gmail拒绝 -->
            <prop key="mail.smtp.ssl.protocols">TLSv1.2 TLSv1.3</prop>
            <!-- 信任Gmail的SMTP服务器 -->
            <prop key="mail.smtp.ssl.trust">smtp.gmail.com</prop>
            <!-- 设置连接超时时间，避免长时间等待 -->
            <prop key="mail.smtp.connectiontimeout">5000</prop>
            <prop key="mail.smtp.timeout">5000</prop>
        </props>
    </property>
</bean>

2. 处理Gmail账号权限限制 #

Gmail现在已经禁用了普通密码直接登录SMTP服务，你需要：

• 给你的Gmail账号开启两步验证
• 登录Google账号管理页面，生成一个应用专用密码（App Password），用这个密码替换配置中的普通密码

如果没有开启两步验证，你无法生成应用专用密码，这是目前Gmail允许SMTP登录的唯一合法方式（"不太安全的应用访问"已经被彻底移除）。

3. 检查JavaMail依赖版本 #

确保你使用的是兼容的JavaMail版本，避免因旧版本不支持新的TLS协议导致问题：

• 如果你用的是Spring Boot，直接引入官方的邮件starter即可：

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

• 普通Spring项目可以使用最新的javax.mail依赖：

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

4. 排查网络问题 #

如果以上配置都没问题，那可能是网络环境的问题：

• 检查服务器/本地机器的防火墙是否拦截了587端口
• 如果使用代理，确保代理配置正确，允许访问smtp.gmail.com的587端口
• 可以尝试执行telnet smtp.gmail.com 587命令，测试是否能正常连接到Gmail的SMTP服务器

测试示例 #

你可以用一个简单的邮件服务类来验证配置是否生效：

import org.springframework.mail.SimpleMailMessage;
import org.springframework.mail.javamail.JavaMailSender;
import org.springframework.stereotype.Service;

@Service
public class EmailService {
    private final JavaMailSender mailSender;

    // 构造函数注入mailSender
    public EmailService(JavaMailSender mailSender) {
        this.mailSender = mailSender;
    }

    public void sendTestEmail() {
        SimpleMailMessage message = new SimpleMailMessage();
        message.setFrom("your-email@gmail.com");
        message.setTo("recipient@example.com");
        message.setSubject("Test Email from JavaMail");
        message.setText("This is a test email to verify the SMTP configuration.");
        
        mailSender.send(message);
    }
}

按照这些步骤调整后，应该就能解决TLS转换的问题了。

内容的提问来源于stack exchange，提问作者rk13