GAE邮件服务问题：发送邮件时抛出javax.mail.MessagingException异常

你遇到的这个javax.mail.MessagingException: Could not connect to SMTP host: localhost, port: 25错误，本质是JavaMail默认尝试连接本地SMTP服务器，但不管是本地开发环境还是GAE生产环境，都需要适配GAE的邮件服务规则来配置。下面分场景给出具体修复方案：

一、部署到GAE生产环境的修复 #

GAE标准环境内置了邮件服务，完全不需要手动配置SMTP服务器，平台会自动处理邮件传输。你的代码问题在于没正确利用这个内置能力，调整步骤如下：

1. 确认发件人邮箱合规：必须使用[你的应用ID]@appspotmail.com格式的邮箱，或者在GAE控制台验证过的自定义域名邮箱。
2. 简化Session创建逻辑：不需要手动设置SMTP相关属性，GAE会自动注入正确配置。修改后的代码示例：

protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
    // 无需手动配置Properties，GAE会处理底层传输
    Session session = Session.getInstance(new Properties(), null);
    try {
        Message msg = new MimeMessage(session);
        // 发件人必须符合GAE要求的格式
        msg.setFrom(new InternetAddress("你的应用ID@appspotmail.com", "Example.com Admin"));
        msg.addRecipient(Message.RecipientType.TO, new InternetAddress("目标收件人邮箱@gmail.com"));
        msg.setSubject("GAE测试邮件");
        msg.setText("这是通过GAE内置邮件服务发送的测试内容");
        // 直接调用发送，GAE会自动处理SMTP连接
        Transport.send(msg);
        resp.getWriter().println("邮件发送成功！");
    } catch (MessagingException e) {
        e.printStackTrace();
        resp.getWriter().println("邮件发送失败：" + e.getMessage());
    }
}

3. 权限检查：确保appengine-web.xml中没有限制邮件服务的权限，GAE默认允许发送邮件，无需额外配置。

二、本地开发环境的测试修复 #

本地运行DevAppServer时，GAE不会提供真实的SMTP服务，需要配置外部SMTP服务器（比如Gmail的SMTP）来测试：

1. 添加SMTP配置到Properties：

Properties props = new Properties();
props.put("mail.smtp.host", "smtp.gmail.com");
props.put("mail.smtp.port", "587");
props.put("mail.smtp.auth", "true");
props.put("mail.smtp.starttls.enable", "true");

// 创建带身份验证的Session
Session session = Session.getInstance(props, new Authenticator() {
    protected PasswordAuthentication getPasswordAuthentication() {
        // 注意：Gmail需开启两步验证并使用应用专用密码，不能用普通登录密码
        return new PasswordAuthentication("你的Gmail邮箱地址", "Gmail应用专用密码");
    }
});

2. 注意事项：
   • 使用Gmail时，必须开启两步验证并生成应用专用密码，否则会触发安全验证失败。
   • 本地测试时，发件人可以用你的Gmail邮箱，无需局限于appspotmail.com格式。

常见排查点 #

• 生产环境中，确认应用ID与发件人邮箱前缀完全一致（比如应用ID是my-test-app，发件人就是my-test-app@appspotmail.com）。
• 本地测试时，检查防火墙是否限制了SMTP端口（587）的出站连接。
• 生产环境下可以查看GAE控制台的日志，里面会有邮件发送失败的详细原因。

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