如何配置Apache James接收任意bar.com子域的入站邮件

一、优先采用的原生支持方案 #

SMTP服务在mailet处理器链执行前，会率先调用DomainList组件校验收件人域名合法性，校验不通过时直接返回拒收响应，不会进入后续处理流程，这也是之前添加的全匹配自定义mailet无法被触发的核心原因。
James原生提供支持通配符域匹配的DomainList装饰实现，无需编写代码即可替换原有JPADomainList配置：

• 修改domainlist.xml配置，将原有顶层DomainList实现替换为通配符支持的包装类，嵌套保留原有JPADomainList的全部配置项：

  <domainlist>
      <domainlist class="org.apache.james.domainlist.wildcard.WildcardSupportedDomainList">
          <!-- 嵌套原有JPADomainList的全部参数，保持原有配置逻辑不变 -->
          <domainlist class="org.apache.james.domainlist.jpa.JPADomainList">
              <autodetect>true</autodetect>
              <autodetectIP>true</autodetectIP>
              <defaultDomain>localhost</defaultDomain>
              <domainnames>
                  <!-- 配置需要匹配的根域，无需逐个枚举子域 -->
                  <domainname>bar.com</domainname>
              </domainnames>
          </domainlist>
      </domainlist>
  </domainlist>
  

• 配置生效逻辑：通配符实现会自动对已配置的域做后缀匹配，所有以bar.com为后缀的收件域（如baz.bar.com、test.a.bar.com）都会被判定为合法域，可正常进入后续邮件处理流程。
• 若需要实现任意域名接收，只需将上述domainnames下的配置改为<domainname>*</domainname>，通配符组件会自动匹配所有收件人域名。

此前排查动作的对应逻辑说明：
调整fetchmail.xml规则无法放行邮件属于正常结果，fetchmail是负责从外部POP3/IMAP服务器拉取邮件的组件，完全不参与本地SMTP端口的入站邮件域校验流程，其配置调整不会影响入站邮件的拒收逻辑。

二、兜底实现方案（适用于低版本James无原生通配符组件的场景） #

如果使用的James版本未提供上述原生通配符DomainList组件，可通过简单自定义实现满足需求：

• 编写自定义DomainList实现类，继承原有JPADomainList，仅重写containsDomain(String domain)方法：
  • 若仅需接收所有bar.com子域邮件：在方法中添加判断逻辑，只要传入的域以.bar.com为后缀即返回true，其余域名走原有JPADomainList的默认校验逻辑
  • 若需接收任意域名的入站邮件：直接在重写方法中返回true即可
• 修改domainlist.xml中顶层domainlist的class属性为自定义实现类的全路径，重启服务即可生效。
• 该自定义实现作用于SMTP前置域校验环节，可解决之前自定义mailet因前置校验拦截无法触发的问题。

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