Chatwoot SMTP配置问题排查与解决方案

问题背景

在使用Chatwoot自托管版本时，用户遇到了SMTP邮件发送失败的问题。系统错误日志显示邮件投递失败，错误信息指向sendmail命令执行异常。用户尝试配置了Mailgun和AWS SES两种SMTP服务，但问题依然存在。

错误现象

系统日志中出现了以下关键错误信息：

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

这表明系统没有正确使用配置的SMTP服务，而是回退到了默认的sendmail方式。

根本原因分析

1. 环境变量未生效：系统未能正确读取SMTP配置的环境变量，导致回退到sendmail
2. 配置格式问题：SMTP参数可能存在格式错误或不完整
3. 服务重启问题：修改环境变量后未正确重启相关服务

解决方案

1. 验证SMTP配置

确保在环境变量中正确配置了以下参数：

MAILER_SENDER_EMAIL=您的发件邮箱
SMTP_ADDRESS=smtp服务地址
SMTP_AUTHENTICATION=认证方式(通常为plain)
SMTP_DOMAIN=您的邮件域名
SMTP_ENABLE_STARTTLS_AUTO=true
SMTP_PORT=端口号(587或465)
SMTP_USERNAME=SMTP用户名
SMTP_PASSWORD=SMTP密码

2. 调试SMTP连接

可以通过Rails控制台直接测试SMTP连接：

mailer = ActionMailer::Base.new
mailer.delivery_method = :smtp
mailer.smtp_settings = {
  address: 'smtp.mailgun.org',
  port: 587,
  domain: 'yourdomain.com',
  user_name: 'your_username',
  password: 'your_password',
  authentication: 'plain',
  enable_starttls_auto: true
}

begin
  mailer.mail(from: '[e-mail]', 
             to: '[e-mail]', 
             subject: 'SMTP测试', 
             body: '这是一封测试邮件').deliver
  puts "邮件发送成功"
rescue => e
  puts "邮件发送失败: #{e.message}"
end

3. 服务重启步骤

修改环境变量后，必须完全重启Chatwoot服务：

1. 停止所有Chatwoot容器
2. 确认环境变量已更新
3. 重新启动所有服务

4. 检查Docker配置

如果使用Docker部署，确保：

• 环境变量正确传递到容器内部
• 没有在多个地方重复定义SMTP配置
• 没有旧的容器实例在运行

最佳实践建议

1. 使用专业的SMTP服务而非系统自带的sendmail
2. 在修改配置前备份现有设置
3. 使用单独的邮箱账户作为发件人，不要使用个人邮箱
4. 定期检查邮件发送日志
5. 考虑设置邮件发送失败时的告警机制

总结

SMTP配置问题在自托管应用中很常见，通常是由于环境变量未正确加载或配置格式错误导致。通过系统性的验证和调试，可以快速定位并解决问题。Chatwoot作为客户服务平台，可靠的邮件功能至关重要，建议在正式环境部署前充分测试邮件发送功能。