使用Mailchimp 3.0 API与Gibbon（Rails）检查邮件列表成员是否存在

我之前用Gibbon对接Mailchimp API时也踩过这个坑！当你查询的邮箱不在目标列表里时，Mailchimp API会返回404 Not Found的HTTP状态码，而Gibbon gem默认会把所有非2xx的响应转换成Gibbon::MailChimpError异常抛出，这就是导致你代码崩溃的原因。

下面给你两种实用的解决方案，还有一个关键的注意点：

方案一：捕获异常处理（推荐，逻辑清晰） #

直接通过rescue捕获404异常，区分“邮箱不存在”和其他API错误：

list_id = ENV['MAILCHIMP_LIST_ID']
@gibbon = Gibbon::Request.new(api_key: ENV['mailchimp_api_key'], symbolize_keys: true)
# 关键：Mailchimp的member_id是基于小写邮箱的MD5，必须转小写！
@member_id = Digest::MD5.hexdigest(params[:user_Email].downcase)

begin
  # 查询存在的成员，正常返回数据
  @member_info = @gibbon.lists(list_id).members(@member_id).retrieve.body
  status = @member_info[:status]
  # 这里写邮箱存在时的业务逻辑，比如返回订阅状态
rescue Gibbon::MailChimpError => e
  if e.status_code == 404
    # 邮箱不在列表中的处理逻辑
    status = "not_found"
  else
    # 其他API错误，比如权限不足、列表ID无效等，可根据需求处理
    puts "Mailchimp API错误：#{e.message}"
    raise e # 或者自定义错误处理逻辑
  end
end

方案二：关闭Gibbon默认异常处理 #

初始化Gibbon时设置skip_default_error_handler: true，手动判断响应状态码：

list_id = ENV['MAILCHIMP_LIST_ID']
@gibbon = Gibbon::Request.new(
  api_key: ENV['mailchimp_api_key'],
  symbolize_keys: true,
  skip_default_error_handler: true # 关闭默认异常抛出
)
@member_id = Digest::MD5.hexdigest(params[:user_Email].downcase)

response = @gibbon.lists(list_id).members(@member_id).retrieve
case response.status_code
when 200
  status = response.body[:status]
  # 处理邮箱存在的逻辑
when 404
  status = "not_found"
  # 处理邮箱不存在的逻辑
else
  # 其他错误情况，打印详细错误信息排查
  puts "API请求失败：#{response.body[:detail]}"
end

重要注意事项 #

• 邮箱必须转小写：Mailchimp生成member_id时是基于小写邮箱地址的，哪怕用户输入的是User@Example.com，你也需要先转成user@example.com再生成MD5，否则会出现“明明邮箱在列表里却查不到”的情况。

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