Chatwoot邮件发送问题排查指南：Sendmail错误解决方案

问题现象

在使用Chatwoot 3.14版本（也尝试过3.9版本）通过easypanel安装在Contabo VPS上时，当创建新客服账号时系统无法发送验证邮件，并返回以下错误信息：

Mail::Sendmail::DeliveryError: Delivery failed with exitstatus 1: "/usr/sbin/sendmail -i -f \"[e-mail]\" --\"[e-mail]\""

问题分析

从错误信息可以看出，系统仍然在使用sendmail进行邮件发送，而不是按照配置使用SMTP服务。这表明环境变量配置可能未被正确加载或应用。

配置检查要点

1. SMTP环境变量配置： 确保以下SMTP相关环境变量已正确设置：

   • MAILER_SENDER_EMAIL
   • SMTP_ADDRESS
   • SMTP_USERNAME
   • SMTP_PASSWORD
   • SMTP_PORT
   • SMTP_DOMAIN
   • SMTP_AUTHENTICATION
   • SMTP_OPENSSL_VERIFY_MODE
   • SMTP_ENABLE_STARTTLS_AUTO

2. 配置应用范围： 这些环境变量需要在Chatwoot的两个主要组件中都进行配置：

   • Web服务容器
   • Worker工作容器

3. 配置验证： 可以通过进入容器内部执行env命令来验证环境变量是否已正确加载。

解决方案

1. 检查easypanel配置： 确认在easypanel中为Chatwoot服务配置的环境变量是否已正确应用到所有相关容器。

2. 重启服务： 在修改环境变量后，需要重启Chatwoot服务以使更改生效。

3. 测试SMTP连接： 可以通过在容器内手动测试SMTP连接来验证配置是否正确：

   telnet SMTP_ADDRESS SMTP_PORT
   

4. 日志检查： 检查Chatwoot的日志文件，特别是worker日志，查看是否有关于SMTP配置加载的更多信息。

常见问题排查

1. 端口问题： 确保SMTP端口（如587）未被防火墙阻止。

2. 认证问题： 检查SMTP用户名和密码是否正确，特别是当使用Gmail等第三方服务时，可能需要应用专用密码。

3. TLS配置： 确保SMTP_ENABLE_STARTTLS_AUTO设置为true，SMTP_OPENSSL_VERIFY_MODE设置正确。

4. 发件人地址： 确认MAILER_SENDER_EMAIL与SMTP_USERNAME匹配，某些SMTP服务要求两者一致。

总结

当Chatwoot出现邮件发送问题时，首先需要确认系统是否真正使用了配置的SMTP服务而非默认的sendmail。通过全面检查环境变量配置、验证服务重启后的实际行为，以及测试SMTP连接，通常可以解决大多数邮件发送问题。对于使用easypanel等管理面板的情况，还需要特别注意配置是否被正确应用到所有相关服务容器中。