Spring Boot部署AWS ECS时出现无法确定本地邮箱地址错误

本地运行Spring Boot应用时发送邮件无异常，但部署至AWS ECS后，发送邮件时返回500状态码，报错信息如下：

org.springframework.mail.MailSendException: Failed messages: javax.mail.MessagingException: can't determine local email address; message exceptions (1) are:
Failed message 1: javax.mail.MessagingException: can't determine local email address

相关发送邮件代码：

public void sendConformationEmail(User user, Locale locale, String appUrl){

    String token = UUID.randomUUID().toString();
    createVerificationToken(user, token);

    String recipientAddress = user.getEmail();
    String subject = "IO Employee Registration Confirmation";
    String confirmationUrl = appUrl + "/email/confirm?token=" + token;
    String message = messages.getMessage("message.regSuccLink", null, "You registered successfully. To confirm your registration, please click on the below link.", locale);

    SimpleMailMessage email = new SimpleMailMessage();
    email.setTo(recipientAddress);
    email.setSubject(subject);
    email.setFrom(env.getProperty("spring.mail.username"));

    email.setText(message + "\r\n" + serverAddress + confirmationUrl);
    mailSender.send(email);
}

使用Gmail SMTP服务器，代码中已调用setFrom()设置发件人仍出现该问题，解决方案如下：

• 确认ECS环境配置有效性：检查ECS任务定义的环境变量或挂载的配置文件，确保spring.mail.username属性已正确配置且不为空，避免setFrom()传入无效值。
• 强制指定JavaMail本地标识：在Spring配置文件（application.properties/yml）中添加以下配置，跳过ECS容器hostname解析逻辑：

  spring.mail.from=你的Gmail账号@gmail.com
  spring.mail.properties.mail.smtp.localhost=gmail.com
  

  该配置会让JavaMail使用指定的地址作为本地标识，解决无法自动识别本地邮件地址的问题。
• 检查网络访问权限：确认ECS容器所在的安全组、网络ACL已开放出站访问Gmail SMTP服务器587端口的规则，避免因网络阻断导致的异常。
• 适配Gmail账号验证规则：若Gmail账号开启了两步验证，需使用应用专用密码替代普通密码作为spring.mail.password的值；未开启两步验证的账号，需确保已启用“不太安全的应用访问”权限。

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