fix 修复 邮件工具失效问题

疯狂的狮子Li

2023-04-13 9c22f7a0d0d696a4e3ce0cb420328a8fb34cf264

fix 修复 邮件工具失效问题

 ruoyi-common/ruoyi-common-mail/pom.xml

@@ -26,6 +26,10 @@
            <groupId>jakarta.mail</groupId>
            <artifactId>jakarta.mail-api</artifactId>
        </dependency>
        <dependency>
            <groupId>org.eclipse.angus</groupId>
            <artifactId>jakarta.mail</artifactId>
        </dependency>
    </dependencies>

</project>

 ruoyi-common/ruoyi-common-mail/src/main/java/org/dromara/common/mail/config/MailConfig.java

@@ -1,7 +1,7 @@
package org.dromara.common.mail.config;

import cn.hutool.extra.mail.MailAccount;
import org.dromara.common.mail.config.properties.MailProperties;
import org.dromara.common.mail.utils.MailAccount;
import org.springframework.boot.autoconfigure.AutoConfiguration;
import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty;
import org.springframework.boot.context.properties.EnableConfigurationProperties;

 ruoyi-common/ruoyi-common-mail/src/main/java/org/dromara/common/mail/utils/GlobalMailAccount.java

¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,47 @@
package org.dromara.common.mail.utils;

import cn.hutool.core.io.IORuntimeException;

/**
 * å…¨å±€é‚®ä»¶å¸æˆ·ï¼Œä¾èµ–于邮件配置文件{@link MailAccount#MAIL_SETTING_PATHS}
 *
 * @author looly
 *
 */
public enum GlobalMailAccount {
    INSTANCE;

    private final MailAccount mailAccount;

    /**
     * æž„造
     */
    GlobalMailAccount() {
        mailAccount = createDefaultAccount();
    }

    /**
     * èŽ·å¾—邮件帐户
     *
     * @return é‚®ä»¶å¸æˆ·
     */
    public MailAccount getAccount() {
        return this.mailAccount;
    }

    /**
     * åˆ›å»ºé»˜è®¤å¸æˆ·
     *
     * @return MailAccount
     */
    private MailAccount createDefaultAccount() {
        for (String mailSettingPath : MailAccount.MAIL_SETTING_PATHS) {
            try {
                return new MailAccount(mailSettingPath);
            } catch (IORuntimeException ignore) {
                //ignore
            }
        }
        return null;
    }
}

 ruoyi-common/ruoyi-common-mail/src/main/java/org/dromara/common/mail/utils/InternalMailUtil.java

@@ -1,7 +1,6 @@
package org.dromara.common.mail.utils;

import cn.hutool.core.util.ArrayUtil;
import cn.hutool.extra.mail.MailException;
import jakarta.mail.internet.AddressException;
import jakarta.mail.internet.InternetAddress;
import jakarta.mail.internet.MimeUtility;

 ruoyi-common/ruoyi-common-mail/src/main/java/org/dromara/common/mail/utils/Mail.java

@@ -7,7 +7,6 @@
import cn.hutool.core.util.ArrayUtil;
import cn.hutool.core.util.ObjectUtil;
import cn.hutool.core.util.StrUtil;
import cn.hutool.extra.mail.*;
import jakarta.activation.DataHandler;
import jakarta.activation.DataSource;
import jakarta.activation.FileDataSource;

 ruoyi-common/ruoyi-common-mail/src/main/java/org/dromara/common/mail/utils/MailAccount.java

¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,657 @@
package org.dromara.common.mail.utils;

import cn.hutool.core.util.CharsetUtil;
import cn.hutool.core.util.ObjectUtil;
import cn.hutool.core.util.StrUtil;
import cn.hutool.setting.Setting;

import java.io.Serializable;
import java.nio.charset.Charset;
import java.util.HashMap;
import java.util.Map;
import java.util.Properties;

/**
 * é‚®ä»¶è´¦æˆ·å¯¹è±¡
 *
 * @author Luxiaolei
 */
public class MailAccount implements Serializable {
    private static final long serialVersionUID = -6937313421815719204L;

    private static final String MAIL_PROTOCOL = "mail.transport.protocol";
    private static final String SMTP_HOST = "mail.smtp.host";
    private static final String SMTP_PORT = "mail.smtp.port";
    private static final String SMTP_AUTH = "mail.smtp.auth";
    private static final String SMTP_TIMEOUT = "mail.smtp.timeout";
    private static final String SMTP_CONNECTION_TIMEOUT = "mail.smtp.connectiontimeout";
    private static final String SMTP_WRITE_TIMEOUT = "mail.smtp.writetimeout";

    // SSL
    private static final String STARTTLS_ENABLE = "mail.smtp.starttls.enable";
    private static final String SSL_ENABLE = "mail.smtp.ssl.enable";
    private static final String SSL_PROTOCOLS = "mail.smtp.ssl.protocols";
    private static final String SOCKET_FACTORY = "mail.smtp.socketFactory.class";
    private static final String SOCKET_FACTORY_FALLBACK = "mail.smtp.socketFactory.fallback";
    private static final String SOCKET_FACTORY_PORT = "smtp.socketFactory.port";

    // System Properties
    private static final String SPLIT_LONG_PARAMS = "mail.mime.splitlongparameters";
    //private static final String ENCODE_FILE_NAME = "mail.mime.encodefilename";
    //private static final String CHARSET = "mail.mime.charset";

    // å…¶ä»–
    private static final String MAIL_DEBUG = "mail.debug";

    public static final String[] MAIL_SETTING_PATHS = new String[]{"config/mail.setting", "config/mailAccount.setting", "mail.setting"};

    /**
     * SMTP服务器域名
     */
    private String host;
    /**
     * SMTP服务端口
     */
    private Integer port;
    /**
     * æ˜¯å¦éœ€è¦ç”¨æˆ·åå¯†ç éªŒè¯
     */
    private Boolean auth;
    /**
     * ç”¨æˆ·å
     */
    private String user;
    /**
     * å¯†ç 
     */
    private String pass;
    /**
     * å‘送方，遵循RFC-822标准
     */
    private String from;

    /**
     * æ˜¯å¦æ‰“开调试模式，调试模式会显示与邮件服务器通信过程，默认不开启
     */
    private boolean debug;
    /**
     * ç¼–码用于编码邮件正文和发送人、收件人等中文
     */
    private Charset charset = CharsetUtil.CHARSET_UTF_8;
    /**
     * å¯¹äºŽè¶…长参数是否切分为多份，默认为false（国内邮箱附件不支持切分的附件名）
     */
    private boolean splitlongparameters = false;
    /**
     * å¯¹äºŽæ–‡ä»¶åæ˜¯å¦ä½¿ç”¨{@link #charset}编码，默认为 {@code true}
     */
    private boolean encodefilename = true;

    /**
     * ä½¿ç”¨ STARTTLS安全连接，STARTTLS是对纯文本通信协议的扩展。它将纯文本连接升级为加密连接（TLS或SSL）， è€Œä¸æ˜¯ä½¿ç”¨ä¸€ä¸ªå•ç‹¬çš„加密通信端口。
     */
    private boolean starttlsEnable = false;
    /**
     * ä½¿ç”¨ SSL安全连接
     */
    private Boolean sslEnable;

    /**
     * SSL协议，多个协议用空格分隔
     */
    private String sslProtocols;

    /**
     * æŒ‡å®šå®žçŽ°javax.net.SocketFactory接口的类的名称,这个类将被用于创建SMTP的套接字
     */
    private String socketFactoryClass = "javax.net.ssl.SSLSocketFactory";
    /**
     * å¦‚果设置为true,未能创建一个套接字使用指定的套接字工厂类将导致使用java.net.Socket创建的套接字类, é»˜è®¤å€¼ä¸ºtrue
     */
    private boolean socketFactoryFallback;
    /**
     * æŒ‡å®šçš„端口连接到在使用指定的套接字工厂。如果没有设置,将使用默认端口
     */
    private int socketFactoryPort = 465;

    /**
     * SMTP超时时长，单位毫秒，缺省值不超时
     */
    private long timeout;
    /**
     * Socket连接超时值，单位毫秒，缺省值不超时
     */
    private long connectionTimeout;
    /**
     * Socket写出超时值，单位毫秒，缺省值不超时
     */
    private long writeTimeout;

    /**
     * è‡ªå®šä¹‰çš„其他属性，此自定义属性会覆盖默认属性
     */
    private final Map<String, Object> customProperty = new HashMap<>();

    // -------------------------------------------------------------- Constructor start

    /**
     * æž„造,所有参数需自行定义或保持默认值
     */
    public MailAccount() {
    }

    /**
     * æž„造
     *
     * @param settingPath é…ç½®æ–‡ä»¶è·¯å¾„
     */
    public MailAccount(String settingPath) {
        this(new Setting(settingPath));
    }

    /**
     * æž„造
     *
     * @param setting é…ç½®æ–‡ä»¶
     */
    public MailAccount(Setting setting) {
        setting.toBean(this);
    }

    // -------------------------------------------------------------- Constructor end

    /**
     * èŽ·å¾—SMTP服务器域名
     *
     * @return SMTP服务器域名
     */
    public String getHost() {
        return host;
    }

    /**
     * è®¾ç½®SMTP服务器域名
     *
     * @param host SMTP服务器域名
     * @return this
     */
    public MailAccount setHost(String host) {
        this.host = host;
        return this;
    }

    /**
     * èŽ·å¾—SMTP服务端口
     *
     * @return SMTP服务端口
     */
    public Integer getPort() {
        return port;
    }

    /**
     * è®¾ç½®SMTP服务端口
     *
     * @param port SMTP服务端口
     * @return this
     */
    public MailAccount setPort(Integer port) {
        this.port = port;
        return this;
    }

    /**
     * æ˜¯å¦éœ€è¦ç”¨æˆ·åå¯†ç éªŒè¯
     *
     * @return æ˜¯å¦éœ€è¦ç”¨æˆ·åå¯†ç éªŒè¯
     */
    public Boolean isAuth() {
        return auth;
    }

    /**
     * è®¾ç½®æ˜¯å¦éœ€è¦ç”¨æˆ·åå¯†ç éªŒè¯
     *
     * @param isAuth æ˜¯å¦éœ€è¦ç”¨æˆ·åå¯†ç éªŒè¯
     * @return this
     */
    public MailAccount setAuth(boolean isAuth) {
        this.auth = isAuth;
        return this;
    }

    /**
     * èŽ·å–用户名
     *
     * @return ç”¨æˆ·å
     */
    public String getUser() {
        return user;
    }

    /**
     * è®¾ç½®ç”¨æˆ·å
     *
     * @param user ç”¨æˆ·å
     * @return this
     */
    public MailAccount setUser(String user) {
        this.user = user;
        return this;
    }

    /**
     * èŽ·å–密码
     *
     * @return å¯†ç 
     */
    public String getPass() {
        return pass;
    }

    /**
     * è®¾ç½®å¯†ç 
     *
     * @param pass å¯†ç 
     * @return this
     */
    public MailAccount setPass(String pass) {
        this.pass = pass;
        return this;
    }

    /**
     * èŽ·å–发送方，遵循RFC-822标准
     *
     * @return å‘送方，遵循RFC-822标准
     */
    public String getFrom() {
        return from;
    }

    /**
     * è®¾ç½®å‘送方，遵循RFC-822标准<br>
     * å‘件人可以是以下形式：
     *
     * <pre>
     * 1. user@xxx.xx
     * 2.  name &lt;user@xxx.xx&gt;
     * </pre>
     *
     * @param from å‘送方，遵循RFC-822标准
     * @return this
     */
    public MailAccount setFrom(String from) {
        this.from = from;
        return this;
    }

    /**
     * æ˜¯å¦æ‰“开调试模式，调试模式会显示与邮件服务器通信过程，默认不开启
     *
     * @return æ˜¯å¦æ‰“开调试模式，调试模式会显示与邮件服务器通信过程，默认不开启
     * @since 4.0.2
     */
    public boolean isDebug() {
        return debug;
    }

    /**
     * è®¾ç½®æ˜¯å¦æ‰“开调试模式，调试模式会显示与邮件服务器通信过程，默认不开启
     *
     * @param debug æ˜¯å¦æ‰“开调试模式，调试模式会显示与邮件服务器通信过程，默认不开启
     * @return this
     * @since 4.0.2
     */
    public MailAccount setDebug(boolean debug) {
        this.debug = debug;
        return this;
    }

    /**
     * èŽ·å–字符集编码
     *
     * @return ç¼–码，可能为{@code null}
     */
    public Charset getCharset() {
        return charset;
    }

    /**
     * è®¾ç½®å­—符集编码，此选项不会修改全局配置，若修改全局配置，请设置此项为{@code null}并设置：
     * <pre>
     *     System.setProperty("mail.mime.charset", charset);
     * </pre>
     *
     * @param charset å­—符集编码，{@code null} åˆ™è¡¨ç¤ºä½¿ç”¨å…¨å±€è®¾ç½®çš„默认编码，全局编码为mail.mime.charset系统属性
     * @return this
     */
    public MailAccount setCharset(Charset charset) {
        this.charset = charset;
        return this;
    }

    /**
     * å¯¹äºŽè¶…长参数是否切分为多份，默认为false（国内邮箱附件不支持切分的附件名）
     *
     * @return å¯¹äºŽè¶…长参数是否切分为多份
     */
    public boolean isSplitlongparameters() {
        return splitlongparameters;
    }

    /**
     * è®¾ç½®å¯¹äºŽè¶…长参数是否切分为多份，默认为false（国内邮箱附件不支持切分的附件名）<br>
     * æ³¨æ„æ­¤é¡¹ä¸ºå…¨å±€è®¾ç½®ï¼Œæ­¤é¡¹ä¼šè°ƒç”¨
     * <pre>
     * System.setProperty("mail.mime.splitlongparameters", true)
     * </pre>
     *
     * @param splitlongparameters å¯¹äºŽè¶…长参数是否切分为多份
     */
    public void setSplitlongparameters(boolean splitlongparameters) {
        this.splitlongparameters = splitlongparameters;
    }

    /**
     * å¯¹äºŽæ–‡ä»¶åæ˜¯å¦ä½¿ç”¨{@link #charset}编码，默认为 {@code true}
     *
     * @return å¯¹äºŽæ–‡ä»¶åæ˜¯å¦ä½¿ç”¨{@link #charset}编码，默认为 {@code true}
     * @since 5.7.16
     */
    public boolean isEncodefilename() {

        return encodefilename;
    }

    /**
     * è®¾ç½®å¯¹äºŽæ–‡ä»¶åæ˜¯å¦ä½¿ç”¨{@link #charset}编码，此选项不会修改全局配置<br>
     * å¦‚果此选项设置为{@code false}，则是否编码取决于两个系统属性：
     * <ul>
     *     <li>mail.mime.encodefilename  æ˜¯å¦ç¼–码附件文件名</li>
     *     <li>mail.mime.charset         ç¼–码文件名的编码</li>
     * </ul>
     *
     * @param encodefilename å¯¹äºŽæ–‡ä»¶åæ˜¯å¦ä½¿ç”¨{@link #charset}编码
     * @since 5.7.16
     */
    public void setEncodefilename(boolean encodefilename) {
        this.encodefilename = encodefilename;
    }

    /**
     * æ˜¯å¦ä½¿ç”¨ STARTTLS安全连接，STARTTLS是对纯文本通信协议的扩展。它将纯文本连接升级为加密连接（TLS或SSL）， è€Œä¸æ˜¯ä½¿ç”¨ä¸€ä¸ªå•ç‹¬çš„加密通信端口。
     *
     * @return æ˜¯å¦ä½¿ç”¨ STARTTLS安全连接
     */
    public boolean isStarttlsEnable() {
        return this.starttlsEnable;
    }

    /**
     * è®¾ç½®æ˜¯å¦ä½¿ç”¨STARTTLS安全连接，STARTTLS是对纯文本通信协议的扩展。它将纯文本连接升级为加密连接（TLS或SSL）， è€Œä¸æ˜¯ä½¿ç”¨ä¸€ä¸ªå•ç‹¬çš„加密通信端口。
     *
     * @param startttlsEnable æ˜¯å¦ä½¿ç”¨STARTTLS安全连接
     * @return this
     */
    public MailAccount setStarttlsEnable(boolean startttlsEnable) {
        this.starttlsEnable = startttlsEnable;
        return this;
    }

    /**
     * æ˜¯å¦ä½¿ç”¨ SSL安全连接
     *
     * @return æ˜¯å¦ä½¿ç”¨ SSL安全连接
     */
    public Boolean isSslEnable() {
        return this.sslEnable;
    }

    /**
     * è®¾ç½®æ˜¯å¦ä½¿ç”¨SSL安全连接
     *
     * @param sslEnable æ˜¯å¦ä½¿ç”¨SSL安全连接
     * @return this
     */
    public MailAccount setSslEnable(Boolean sslEnable) {
        this.sslEnable = sslEnable;
        return this;
    }

    /**
     * èŽ·å–SSL协议，多个协议用空格分隔
     *
     * @return SSL协议，多个协议用空格分隔
     * @since 5.5.7
     */
    public String getSslProtocols() {
        return sslProtocols;
    }

    /**
     * è®¾ç½®SSL协议，多个协议用空格分隔
     *
     * @param sslProtocols SSL协议，多个协议用空格分隔
     * @since 5.5.7
     */
    public void setSslProtocols(String sslProtocols) {
        this.sslProtocols = sslProtocols;
    }

    /**
     * èŽ·å–指定实现javax.net.SocketFactory接口的类的名称,这个类将被用于创建SMTP的套接字
     *
     * @return æŒ‡å®šå®žçŽ°javax.net.SocketFactory接口的类的名称, è¿™ä¸ªç±»å°†è¢«ç”¨äºŽåˆ›å»ºSMTP的套接字
     */
    public String getSocketFactoryClass() {
        return socketFactoryClass;
    }

    /**
     * è®¾ç½®æŒ‡å®šå®žçŽ°javax.net.SocketFactory接口的类的名称,这个类将被用于创建SMTP的套接字
     *
     * @param socketFactoryClass æŒ‡å®šå®žçŽ°javax.net.SocketFactory接口的类的名称,这个类将被用于创建SMTP的套接字
     * @return this
     */
    public MailAccount setSocketFactoryClass(String socketFactoryClass) {
        this.socketFactoryClass = socketFactoryClass;
        return this;
    }

    /**
     * å¦‚果设置为true,未能创建一个套接字使用指定的套接字工厂类将导致使用java.net.Socket创建的套接字类, é»˜è®¤å€¼ä¸ºtrue
     *
     * @return å¦‚果设置为true, æœªèƒ½åˆ›å»ºä¸€ä¸ªå¥—接字使用指定的套接字工厂类将导致使用java.net.Socket创建的套接字类, é»˜è®¤å€¼ä¸ºtrue
     */
    public boolean isSocketFactoryFallback() {
        return socketFactoryFallback;
    }

    /**
     * å¦‚果设置为true,未能创建一个套接字使用指定的套接字工厂类将导致使用java.net.Socket创建的套接字类, é»˜è®¤å€¼ä¸ºtrue
     *
     * @param socketFactoryFallback å¦‚果设置为true,未能创建一个套接字使用指定的套接字工厂类将导致使用java.net.Socket创建的套接字类, é»˜è®¤å€¼ä¸ºtrue
     * @return this
     */
    public MailAccount setSocketFactoryFallback(boolean socketFactoryFallback) {
        this.socketFactoryFallback = socketFactoryFallback;
        return this;
    }

    /**
     * èŽ·å–指定的端口连接到在使用指定的套接字工厂。如果没有设置,将使用默认端口
     *
     * @return æŒ‡å®šçš„端口连接到在使用指定的套接字工厂。如果没有设置,将使用默认端口
     */
    public int getSocketFactoryPort() {
        return socketFactoryPort;
    }

    /**
     * æŒ‡å®šçš„端口连接到在使用指定的套接字工厂。如果没有设置,将使用默认端口
     *
     * @param socketFactoryPort æŒ‡å®šçš„端口连接到在使用指定的套接字工厂。如果没有设置,将使用默认端口
     * @return this
     */
    public MailAccount setSocketFactoryPort(int socketFactoryPort) {
        this.socketFactoryPort = socketFactoryPort;
        return this;
    }

    /**
     * è®¾ç½®SMTP超时时长，单位毫秒，缺省值不超时
     *
     * @param timeout SMTP超时时长，单位毫秒，缺省值不超时
     * @return this
     * @since 4.1.17
     */
    public MailAccount setTimeout(long timeout) {
        this.timeout = timeout;
        return this;
    }

    /**
     * è®¾ç½®Socket连接超时值，单位毫秒，缺省值不超时
     *
     * @param connectionTimeout Socket连接超时值，单位毫秒，缺省值不超时
     * @return this
     * @since 4.1.17
     */
    public MailAccount setConnectionTimeout(long connectionTimeout) {
        this.connectionTimeout = connectionTimeout;
        return this;
    }

    /**
     * è®¾ç½®Socket写出超时值，单位毫秒，缺省值不超时
     *
     * @param writeTimeout Socket写出超时值，单位毫秒，缺省值不超时
     * @return this
     * @since 5.8.3
     */
    public MailAccount setWriteTimeout(long writeTimeout) {
        this.writeTimeout = writeTimeout;
        return this;
    }

    /**
     * èŽ·å–自定义属性列表
     *
     * @return è‡ªå®šä¹‰å‚数列表
     * @since 5.6.4
     */
    public Map<String, Object> getCustomProperty() {
        return customProperty;
    }

    /**
     * è®¾ç½®è‡ªå®šä¹‰å±žæ€§ï¼Œå¦‚mail.smtp.ssl.socketFactory
     *
     * @param key   å±žæ€§åï¼Œç©ºç™½è¢«å¿½ç•¥
     * @param value å±žæ€§å€¼ï¼Œ null被忽略
     * @return this
     * @since 5.6.4
     */
    public MailAccount setCustomProperty(String key, Object value) {
        if (StrUtil.isNotBlank(key) && ObjectUtil.isNotNull(value)) {
            this.customProperty.put(key, value);
        }
        return this;
    }

    /**
     * èŽ·å¾—SMTP相关信息
     *
     * @return {@link Properties}
     */
    public Properties getSmtpProps() {
        //全局系统参数
        System.setProperty(SPLIT_LONG_PARAMS, String.valueOf(this.splitlongparameters));

        final Properties p = new Properties();
        p.put(MAIL_PROTOCOL, "smtp");
        p.put(SMTP_HOST, this.host);
        p.put(SMTP_PORT, String.valueOf(this.port));
        p.put(SMTP_AUTH, String.valueOf(this.auth));
        if (this.timeout > 0) {
            p.put(SMTP_TIMEOUT, String.valueOf(this.timeout));
        }
        if (this.connectionTimeout > 0) {
            p.put(SMTP_CONNECTION_TIMEOUT, String.valueOf(this.connectionTimeout));
        }
        // issue#2355
        if (this.writeTimeout > 0) {
            p.put(SMTP_WRITE_TIMEOUT, String.valueOf(this.writeTimeout));
        }

        p.put(MAIL_DEBUG, String.valueOf(this.debug));

        if (this.starttlsEnable) {
            //STARTTLS是对纯文本通信协议的扩展。它将纯文本连接升级为加密连接（TLS或SSL）， è€Œä¸æ˜¯ä½¿ç”¨ä¸€ä¸ªå•ç‹¬çš„加密通信端口。
            p.put(STARTTLS_ENABLE, "true");

            if (null == this.sslEnable) {
                //为了兼容旧版本，当用户没有此项配置时，按照starttlsEnable开启状态时对待
                this.sslEnable = true;
            }
        }

        // SSL
        if (null != this.sslEnable && this.sslEnable) {
            p.put(SSL_ENABLE, "true");
            p.put(SOCKET_FACTORY, socketFactoryClass);
            p.put(SOCKET_FACTORY_FALLBACK, String.valueOf(this.socketFactoryFallback));
            p.put(SOCKET_FACTORY_PORT, String.valueOf(this.socketFactoryPort));
            // issue#IZN95@Gitee，在Linux下需自定义SSL协议版本
            if (StrUtil.isNotBlank(this.sslProtocols)) {
                p.put(SSL_PROTOCOLS, this.sslProtocols);
            }
        }

        // è¡¥å……自定义属性，允许自定属性覆盖已经设置的值
        p.putAll(this.customProperty);

        return p;
    }

    /**
     * å¦‚果某些值为null，使用默认值
     *
     * @return this
     */
    public MailAccount defaultIfEmpty() {
        // åŽ»æŽ‰å‘件人的姓名部分
        final String fromAddress = InternalMailUtil.parseFirstAddress(this.from, this.charset).getAddress();

        if (StrUtil.isBlank(this.host)) {
            // å¦‚æžœSMTP地址为空，默认使用smtp.<发件人邮箱后缀>
            this.host = StrUtil.format("smtp.{}", StrUtil.subSuf(fromAddress, fromAddress.indexOf('@') + 1));
        }
        if (StrUtil.isBlank(user)) {
            // å¦‚果用户名为空，默认为发件人（issue#I4FYVY@Gitee）
            //this.user = StrUtil.subPre(fromAddress, fromAddress.indexOf('@'));
            this.user = fromAddress;
        }
        if (null == this.auth) {
            // å¦‚果密码非空白，则使用认证模式
            this.auth = (false == StrUtil.isBlank(this.pass));
        }
        if (null == this.port) {
            // ç«¯å£åœ¨SSL状态下默认与socketFactoryPort一致，非SSL状态下默认为25
            this.port = (null != this.sslEnable && this.sslEnable) ? this.socketFactoryPort : 25;
        }
        if (null == this.charset) {
            // é»˜è®¤UTF-8编码
            this.charset = CharsetUtil.CHARSET_UTF_8;
        }

        return this;
    }

    @Override
    public String toString() {
        return "MailAccount [host=" + host + ", port=" + port + ", auth=" + auth + ", user=" + user + ", pass=" + (StrUtil.isEmpty(this.pass) ? "" : "******") + ", from=" + from + ", startttlsEnable="
                + starttlsEnable + ", socketFactoryClass=" + socketFactoryClass + ", socketFactoryFallback=" + socketFactoryFallback + ", socketFactoryPort=" + socketFactoryPort + "]";
    }
}

 ruoyi-common/ruoyi-common-mail/src/main/java/org/dromara/common/mail/utils/MailException.java

¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,36 @@
package org.dromara.common.mail.utils;

import cn.hutool.core.exceptions.ExceptionUtil;
import cn.hutool.core.util.StrUtil;

/**
 * é‚®ä»¶å¼‚常
 * @author xiaoleilu
 */
public class MailException extends RuntimeException{
    private static final long serialVersionUID = 8247610319171014183L;

    public MailException(Throwable e) {
        super(ExceptionUtil.getMessage(e), e);
    }

    public MailException(String message) {
        super(message);
    }

    public MailException(String messageTemplate, Object... params) {
        super(StrUtil.format(messageTemplate, params));
    }

    public MailException(String message, Throwable throwable) {
        super(message, throwable);
    }

    public MailException(String message, Throwable throwable, boolean enableSuppression, boolean writableStackTrace) {
        super(message, throwable, enableSuppression, writableStackTrace);
    }

    public MailException(Throwable throwable, String messageTemplate, Object... params) {
        super(StrUtil.format(messageTemplate, params), throwable);
    }
}

 ruoyi-common/ruoyi-common-mail/src/main/java/org/dromara/common/mail/utils/MailUtils.java

@@ -5,7 +5,6 @@
import cn.hutool.core.map.MapUtil;
import cn.hutool.core.util.CharUtil;
import cn.hutool.core.util.StrUtil;
import cn.hutool.extra.mail.*;
import org.dromara.common.core.utils.SpringUtils;
import org.dromara.common.core.utils.StringUtils;
import lombok.AccessLevel;