配置自注册邮件确认邮件服务器时遇SMTP连接超时问题

问题核心 #

你配置的邮件服务器是mail.lepgo.online:465，但错误日志显示系统实际尝试连接smtp.gmail.com:578并超时，说明你的自定义配置未生效，或存在配置冲突。

排查与解决步骤 #

• 确认配置文件生效优先级
  WSO2的邮件适配器配置可能存在多来源冲突（如deployment.toml、email-event-adapter.xml），确保你修改的是正确的配置文件，且无其他配置覆盖你的设置。比如在deployment.toml中，邮件配置段应明确为：

  [output_adapter.email]
  from_address= "wso2@lepgo.online"
  username= "wso2@lepgo.online"
  password= "your-real-password"
  hostname= "mail.lepgo.online"
  port= 465
  enable_start_tls= false  # 注意：465是SSL直连端口，无需STARTTLS
  enable_authentication= true
  

  修改后重启WSO2服务，确保配置加载生效。

• 修正端口与加密方式的匹配
  SMTP端口与加密规则对应关系：

  • 465：基于SSL的加密连接，需设置enable_start_tls=false
  • 587：明文连接后通过STARTTLS升级加密，需设置enable_start_tls=true
    你当前port=465同时enable_start_tls=true的配置存在冲突，二选一调整即可。

• 测试网络连通性
  在WSO2服务器所在机器上执行以下命令，验证能否连接你的邮件服务器：

  # 测试端口连通性
  telnet mail.lepgo.online 465
  # 测试SSL连接有效性
  openssl s_client -connect mail.lepgo.online:465
  

  若连接失败，检查服务器防火墙、安全组是否放行465/587端口，或邮件服务器是否限制了WSO2所在IP的访问。

• 验证邮件账号可用性
  用邮件客户端（如Outlook、Thunderbird）配置相同的账号参数，尝试发送测试邮件，确认wso2@lepgo.online账号的SMTP权限、密码均正常。

• 排查硬编码配置残留
  检查WSO2邮件适配器相关配置文件或代码，确认无硬编码的smtp.gmail.com配置，避免系统忽略自定义设置。

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