Azure容器应用中WordPress配置SMTP正确仍无法发送邮件

背景信息 #

已将WordPress站点迁移至虚拟网络（VNet）内的Azure容器应用，站点可通过自定义域名访问，容器应用Ingress配置如下：

"ingress": {
    "external": true,
    "targetPort": 80,
    "exposedPort": 0,
    "transport": "Auto",
    "traffic": [
        {
            "weight": 100,
            "latestRevision": true
        }
    ],
    "customDomains": [
        {
            "name": "app.example-domain.com",
            "certificateId": "some-guid",
            "bindingType": "SniEnabled"
        }
    ],
    "allowInsecure": true,
    "clientCertificateMode": "Ignore",
    "stickySessions": {
        "affinity": "none"
    }
}

容器镜像已包含原Kubernetes环境中可用的SMTP环境变量：

{
    "name": "SMTP_PORT",
    "value": "25"
},
{
    "name": "SMTP_HOSTNAME",
    "value": "smtpinbound.example.com"
}

当前故障：WordPress完全无法发送邮件，应用日志无错误或有效信息，无任何邮件发送尝试痕迹。

已尝试操作 #

• 验证SMTP变量已正确传入容器
• 确认SMTP主机和端口在VNet内可访问
• 确保wp-config.php配置了正确的WP_MAIL_*参数
• 尝试使用WP Mail SMTP插件，无明显效果
• 开启WordPress详细调试日志，仍无邮件相关内容

问题 #

1. 在VNet内的Azure容器应用中使用SMTP有哪些已知限制或注意事项？
2. 如何更好地调试邮件发送尝试缺失的问题？是否有方法深度追踪WordPress或PHP的内部邮件函数？
3. Azure容器应用的网络是否默认限制25端口？若是，最佳解决方案是什么？

解答 #

1. VNet内Azure容器应用使用SMTP的限制与注意事项 #

• 端口限制：Azure容器应用（包括VNet集成实例）默认禁止出站25端口，属于Azure平台级限制，用于防范垃圾邮件发送。
• VNet网络策略：若VNet配置了网络安全组（NSG），需确保出站规则允许容器应用访问目标SMTP服务器的替代端口（如587、465）。
• SMTP服务兼容性：部分企业级SMTP服务要求固定IP或VNet对等连接，需确认容器应用的出站IP已被SMTP服务白名单允许；使用Azure内部SMTP服务（如Exchange Online）时，需采用授权认证方式。
• 环境变量优先级：WordPress不会自动读取SMTP_*环境变量，需确保wp-config.php或插件明确引用这些变量，而非使用硬编码配置。

2. 深度调试邮件发送缺失问题的方法 #

• 直接测试PHP邮件函数：在容器内创建test-mail.php脚本，直接调用mail()函数并输出详细错误：

  <?php
  error_reporting(E_ALL);
  ini_set('display_errors', 1);
  $to = 'test@example.com';
  $subject = 'Test Mail';
  $message = 'This is a test email from Azure Container Apps.';
  $headers = 'From: no-reply@app.example-domain.com' . "\r\n" .
             'Reply-To: no-reply@app.example-domain.com' . "\r\n" .
             'X-Mailer: PHP/' . phpversion();
  
  if(mail($to, $subject, $message, $headers)) {
      echo "Mail sent successfully!";
  } else {
      echo "Mail sending failed. Error: " . (error_get_last()['message'] ?? 'Unknown error');
  }
  ?>
  

  执行脚本后查看输出，同时检查容器的stdout/stderr日志。
• 拦截WordPress邮件钩子：在wp-config.php中添加代码，记录所有wp_mail请求参数：

  add_filter('wp_mail', function($args) {
      error_log('WP Mail Request Details: ' . print_r($args, true));
      return $args;
  });
  

  触发邮件操作后，查看WordPress的debug.log或容器日志。
• 启用PHP邮件日志：修改php.ini或在wp-config.php中配置，开启PHP邮件日志：

  ini_set('mail.log', '/var/log/php-mail.log');
  ini_set('mail.add_x_header', 1);
  

  挂载容器日志目录后，查看该日志文件的详细内容。
• 终端测试SMTP连接：进入容器终端，用telnet或nc测试SMTP服务器连通性：

  telnet smtpinbound.example.com 587
  # 或
  nc -zv smtpinbound.example.com 587
  

  确认连接是否能建立，排查防火墙/NSG拦截问题。

3. Azure容器应用25端口限制的解决方案 #

Azure容器应用默认限制出站25端口，最佳解决方案如下：

• 切换加密端口：使用SMTP服务的587（STARTTLS）或465（SSL/TLS）端口，Azure平台对这些端口无限制，且绝大多数SMTP服务都支持。
• 采用Azure托管SMTP服务：使用Azure Communication Services或Exchange Online，通过API或授权SMTP方式发送邮件，避开端口限制。
• 申请端口解禁（合规场景）：若必须使用25端口，需提交Azure支持工单申请解除限制（仅合规业务场景允许），同时配置VNet NSG出站规则允许25端口访问目标服务器。
• 白名单出站IP：将容器应用的出站IP添加到SMTP服务的白名单，确保通信被允许。

内容的提问来源于stack exchange，提问作者reegan-anne