Java使用GMX IMAP/SMTP服务器收发邮件报认证失败异常如何解决

场景说明 #

使用Java开发邮件系统，基于JavaMail实现邮件收发能力，EmailAccount类构造方法实现如下：

public EmailAccount(String emailId, String password)
{
    super();
    this.emailId = emailId;
    this.password = password;
    
    this.properties = new Properties();
    this.properties.put("incomiongHost", "imap.gmx.com");
    this.properties.put("mail.store.protocol", "imap");

    this.properties.put("mail.transport.protocol", "smtp");
    this.properties.put("mail.smtp.host", "mail.gmx.com");
    this.properties.put("mail.smtp.port", "587");
    this.properties.put("mail.smtp.auth", "true");
    this.properties.put("mail.smtp.user", emailId);
    this.properties.put("mail.smtp.password", password);
    this.properties.put("mail.smtp.starttls.enable", "true");
}

登录校验方法login()实现如下：

public LoginResult login()
{
    Authenticator authenticator = new Authenticator() 
    {
        @Override
        protected PasswordAuthentication getPasswordAuthentication()
        {
            return new PasswordAuthentication(emailAccount.getEmailId(), emailAccount.getPassword());
        }
    };
    
    try
    {
        Session session = Session.getInstance(emailAccount.getProperties(), authenticator);
        Store store = session.getStore("imap");
        store.connect(emailAccount.getProperties().getProperty("incomingHost"), emailAccount.getEmailId(),
                emailAccount.getPassword());
        emailAccount.setMailStore(store);   // use to get mails
    }
    catch(NoSuchProviderException e)
    {
        e.printStackTrace();
        return LoginResult.FAILED_BY_NETWORK;
    }
    catch(AuthenticationFailedException e)
    {
        e.printStackTrace();
        return LoginResult.FAILED_BY_CREDENTIALS;
    }
    catch(MessagingException e)
    {
        e.printStackTrace();
        return LoginResult.FAILED_BY_UNEXPECTED_ERROR;
    }
    catch(Exception e)
    {
        e.printStackTrace();
        return LoginResult.FAILED_BY_UNEXPECTED_ERROR;
    }
    
    return LoginResult.SUCCESS;
}

问题现象 #

已在GMX邮箱后台开启「允许POP3和IMAP收发邮件」权限，确认输入的账号密码和网页端登录完全一致，但代码执行时始终抛出AuthenticationFailedException异常，无法完成登录。

根因与修复方案 #

• 配置键拼写错误：构造方法中IMAP服务器地址的配置键写为incomiongHost（拼写错误，正确拼写为incomingHost），导致login()方法中读取incomingHost配置时得到null，Store连接未指向正确的GMX IMAP服务器地址，直接触发认证失败。
  修正该配置项为：

  this.properties.put("incomingHost", "imap.gmx.com");
  

• IMAP协议配置缺失：GMX的IMAP服务强制要求SSL加密连接，默认端口为993，现有代码未配置IMAP的SSL、端口、认证相关参数，连接时会因协议不匹配被服务端拒绝。需要补充以下IMAP配置：

  this.properties.put("mail.imap.host", "imap.gmx.com");
  this.properties.put("mail.imap.port", "993");
  this.properties.put("mail.imap.ssl.enable", "true");
  this.properties.put("mail.imap.auth", "true");
  

• 账号认证规则限制：如果GMX账号开启了二次验证，网页端登录密码无法用于第三方客户端认证，需要在GMX账号安全设置中生成应用专用密码，将代码中传入的password参数替换为该专用密码即可通过认证。
• 冗余配置清理：mail.smtp.password是无效配置项，JavaMail不会读取该参数完成SMTP认证，SMTP认证密码会从Authenticator或connect方法入参获取，可删除该行配置避免排查误导。

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