GitLab无法接收通知邮件求助：已配置SMTP可发送测试邮件

问题概述 #

已按照《SMTP settings | GitLab》文档完成SMTP配置，GitLab控制台测试邮件可正常发送，但存在以下问题：

• 自建GitLab服务器的Watch级通知邮件无法接收
• 创建新账户时，新用户无法自动收到注册邮件
  需将已配置的SMTP服务器激活为通知邮件服务器，用于发送邀请链接、系统通知等。

排查与解决步骤 #

1. 确认全局邮件通知配置 #

检查gitlab.rb核心配置，确保通知功能未被禁用：

• 编辑配置文件：sudo vi /etc/gitlab/gitlab.rb
• 确保以下关键项正确设置（根据你的SMTP服务商调整参数）：

  # 启用SMTP服务
  gitlab_rails['smtp_enable'] = true
  # 发件人邮箱（需与SMTP服务器允许的发件人匹配）
  gitlab_rails['gitlab_email_from'] = 'gitlab-notify@your-domain.com'
  gitlab_rails['gitlab_email_reply_to'] = 'noreply@your-domain.com'
  # 开启推送等基础通知触发
  gitlab_rails['notify_on_push'] = true
  

• 重载配置并重启GitLab：sudo gitlab-ctl reconfigure && sudo gitlab-ctl restart

2. 检查项目级通知规则 #

全局设置正常的情况下，单个项目的配置可能覆盖默认规则：

• 进入目标项目 → Settings → Notifications
• 确认Watch级别的触发条件已勾选（如推送事件、议题创建、合并请求更新等）
• 检查Email recipients列表，确保无错误过滤规则

3. 验证用户级通知偏好 #

单个用户的个人设置可能导致邮件无法接收：

• 登录用户账号 → Settings → Notifications
• 确认Email notifications设置为On，且对应通知类别（议题、合并请求、推送等）已启用
• 核对用户绑定的邮箱地址是否正确，无拼写错误

4. 排查邮件队列与日志 #

通过日志定位具体故障节点：

• 查看GitLab邮件发送日志：sudo gitlab-ctl tail gitlab-rails/production.log | grep "mail"
• 检查邮件队列积压情况：sudo gitlab-rails runner "puts ActionMailer::Base.deliveries.size"
  • 若队列有积压，手动触发投递：sudo gitlab-rails runner "ActionMailer::Base.deliveries.each { |m| m.deliver_now }"
• 查看SMTP交互细节：sudo gitlab-ctl tail gitlab-rails/production.log | grep "SMTP"，确认邮件是否成功送达SMTP服务器

5. 确认SMTP服务器限制 #

部分服务商对发件人、发送频率有管控：

• 确保gitlab_email_from设置的邮箱已完成服务商侧的验证（如DKIM、SPF域名配置）
• 检查SMTP服务商的发送配额，确认未超出限制
• 查看服务商垃圾邮件拦截记录，确认GitLab邮件未被标记

6. 禁用测试模式配置 #

确保GitLab未处于邮件测试模式：

• 检查gitlab.rb，若存在以下配置则注释掉：

  # gitlab_rails['action_mailer_perform_deliveries'] = false
  # gitlab_rails['action_mailer_delivery_method'] = :test
  

• 确保投递方式为SMTP：

  gitlab_rails['action_mailer_delivery_method'] = :smtp
  

配置截图 #

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