本地部署WSO2 MI配置POP3后无法接收邮件问题咨询

所有操作均在localhost本地环境验证，按以下优先级排查：

• 首先确认全局传输监听器已开启
  7.2.0版本的Micro Integrator默认关闭mailto传输监听，仅在代理服务配置参数不会启动收信线程，需要先在conf/deployment.toml中添加如下配置后重启服务：

  [transport.mail.listener]
  enable = true
  name = "mailto"
  class = "org.apache.axis2.transport.mail.MailTransportListener"
  

• 排查邮箱侧权限与连通性问题（Gmail场景90%故障出在这一步）
  1. 登录Gmail网页端，进入「设置-转发和POP/IMAP」页面，确认已勾选「对所有邮件启用POP」选项，保存设置
  2. 不要使用账号日常登录密码连接：先在Google账号安全中心开启两步验证，再生成16位的应用专用密码，将该密码填入mail.pop3.password配置项，普通密码会被Google安全策略直接拦截连接请求
  3. 本地验证端口连通性：在终端执行telnet pop.gmail.com 995，如果连接超时，说明本地防火墙、网络代理拦截了对应端口，先解决网络连通性问题再调试配置
• 补全代理服务缺失的必填配置项
  你当前贴的配置缺少核心参数，会导致监听器无法定位扫描目标、连接异常断开，修正后的完整参数参考如下：

  <parameter name="transport.mail.Address">你的个人邮箱地址@gmail.com</parameter>
  <parameter name="transport.mail.Protocol">pop3</parameter>
  <parameter name="transport.PollInterval">1</parameter>
  <parameter name="mail.pop3.host">pop.gmail.com</parameter>
  <parameter name="mail.pop3.port">995</parameter>
  <parameter name="mail.pop3.user">建议填完整邮箱地址</parameter>
  <parameter name="mail.pop3.password">Gmail生成的应用专用密码</parameter>
  <parameter name="mail.pop3.socketFactory.class">javax.net.ssl.SSLSocketFactory</parameter>
  <parameter name="mail.pop3.socketFactory.fallback">false</parameter>
  <parameter name="mail.pop3.socketFactory.port">995</parameter>
  <parameter name="transport.mail.ContentType">text/plain</parameter>
  <!-- 缺失的必填参数 -->
  <parameter name="transport.mail.Folder">INBOX</parameter>
  <parameter name="mail.pop3.keepalive">true</parameter>
  <parameter name="transport.mail.ActionAfterProcess">KEEP</parameter>
  <parameter name="mail.pop3.starttls.enable">true</parameter>
  

  其中transport.mail.ActionAfterProcess设为KEEP是测试阶段配置，避免监听器拉取邮件后直接删除源站邮件，测通后可根据业务需求调整为DELETE或MOVE。
• 配置调试技巧
  启动服务时开启DEBUG级日志，直接搜索MailTransportListener关键词的日志输出，会明确打印连接失败的具体原因（认证失败、端口不通、文件夹不存在等），无需盲改配置。

注意：当前配置的ContentType为text/plain，HTML格式、带附件的邮件会被监听器直接过滤，测试阶段可临时将ContentType改为application/octet-stream接收所有类型邮件，功能测通后再调整为业务需要的类型。

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