本地Tomcat环境下Apache Commons邮件发送失败的配置疑问

首先直接说结论：你当前的硬编码配置完全不适合跨平台团队开发场景，而且本地连接失败的原因非常明确——你的Windows机器上根本没有在465端口运行SMTP服务器，所以才会抛出Connection refused错误。咱们一步步解决：

一、先搞定本地开发的邮件发送问题 #

你代码里本地环境指定了localhost:465，但你的电脑上没有搭建SMTP服务，自然连不上。有两种简单的解决思路：

1. 用第三方公共SMTP服务（最快上手） #

不用自己搭服务器，直接用现成的公共服务，比如Gmail、Outlook，或者你们公司专门的测试SMTP服务器。举个Gmail的配置例子：

• 主机：smtp.gmail.com
• 端口：465（SSL）或587（TLS）
• 注意：如果Gmail开启了两步验证，得用应用专用密码而非账号密码；未开启的话需要临时开启“低安全性应用访问”（仅开发测试用，生产环境禁止这么做）

2. 本地搭个简易SMTP服务器（适合纯测试） #

如果不想真的发邮件到外部邮箱，只是想验证代码逻辑，可以装个本地SMTP服务器：

• Windows：可以用Fake SMTP Server这类工具，启动后会监听指定端口，接收邮件并展示在界面上
• Mac/Linux：可以启用自带的Postfix，或者用GreenMail这种Java内嵌的SMTP服务器，方便集成到开发测试流程里

二、硬编码配置的致命问题 #

你把主机、端口、密码都写死在代码里，这在团队开发和生产环境里都是大忌：

• 安全隐患：密码硬编码会被提交到Git仓库，所有团队成员都能看到，万一仓库泄露会造成敏感信息外泄
• 可维护性极差：要修改配置就得改代码、重新编译，没法根据开发/测试/生产环境自动切换
• 跨平台兼容问题：你的同事用Mac/Linux，他们的本地SMTP配置可能和你不一样，硬编码的localhost端口在他们机器上也大概率用不了

三、正确的配置方式：用配置文件分离环境 #

把邮件配置从代码里抽出来，放到专门的配置文件里，不同环境用不同的配置文件：
比如开发环境的mail-dev.properties：

mail.smtp.host=smtp.gmail.com
mail.smtp.port=465
mail.smtp.username=your-dev-email@gmail.com
mail.smtp.password=your-app-password
mail.smtp.ssl.enable=true

生产环境的mail-prod.properties：

mail.smtp.host=mail.mywebsite.com
mail.smtp.port=587
mail.smtp.username=mail@mywebsite.com
mail.smtp.password=your-prod-password
mail.smtp.ssl.enable=false
mail.smtp.starttls.enable=true

然后在代码里读取对应环境的配置文件，而非硬编码。

四、修改后的代码示例 #

这里用Java的Properties来读取配置，实际项目里你可以用Spring的@Value或者其他配置框架来简化：

public void sendPackage(String toEmailAddress, String subject, String content) { 
    // 根据环境切换配置文件
    String configFile = "mail-dev.properties";
    Url url = ((WebRequest)RequestCycle.get().getRequest()).getUrl(); 
    String fullUrl = RequestCycle.get().getUrlRenderer().renderFullUrl(url); 
    if (!fullUrl.toLowerCase().contains("localhost")) {
        configFile = "mail-prod.properties";
    }

    Properties mailProps = new Properties();
    try {
        mailProps.load(getClass().getClassLoader().getResourceAsStream(configFile));
    } catch (IOException e) {
        logger.error("Failed to load mail configuration file: " + configFile, e);
        return;
    }

    try { 
        Email email = new SimpleEmail(); 
        email.setDebug(true); 
        email.setHostName(mailProps.getProperty("mail.smtp.host")); 
        email.setSmtpPort(Integer.parseInt(mailProps.getProperty("mail.smtp.port"))); 
        email.setAuthenticator(new DefaultAuthenticator(
            mailProps.getProperty("mail.smtp.username"),
            mailProps.getProperty("mail.smtp.password")
        )); 
        email.setSSLOnConnect(Boolean.parseBoolean(mailProps.getProperty("mail.smtp.ssl.enable")));
        // 如果是TLS端口，开启STARTTLS
        if (mailProps.containsKey("mail.smtp.starttls.enable")) {
            email.setStartTLSEnabled(Boolean.parseBoolean(mailProps.getProperty("mail.smtp.starttls.enable")));
        }
        email.setFrom(mailProps.getProperty("mail.smtp.username")); 
        email.setSubject(subject); 
        email.setMsg(content); 
        email.addTo(toEmailAddress); 
        email.send(); 
    } catch (EmailException eex) { 
        logger.error("sendPackage failed: " + eex); 
        eex.printStackTrace(); 
    } 
}

五、服务器端需要注意的配置（生产环境） #

当你部署到服务器上时，还要确保：

• 服务器的防火墙允许出站访问SMTP端口（587或465）
• 你的SMTP服务器（比如mail.mywebsite.com）允许服务器IP发送邮件，避免被当成垃圾邮件拦截
• 确认SMTP账号的权限正确，密码没有过期
• 如果用SSL/TLS，确保服务器信任SMTP服务器的证书（生产环境不要忽略证书验证）

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