将Zendesk JSON API数据保存至Ruby on Rails数据库遇阻

嘿，我之前做过类似的Zendesk数据同步需求，碰到过一模一样的保存失败问题，咱们一步步拆解排查：

第一步：确认API请求是否真的拿到有效数据 #

首先得验证从Zendesk API拉回的是不是预期的用户数据。Zendesk的用户接口返回的JSON结构嵌套在"users"字段里，而且如果没处理认证，可能返回的是错误信息而非用户列表。

在你的save_data_from_api方法里先加个打印验证：

def self.save_data_from_api
  uri = URI.parse("https://techcompany.zendesk.com/api/v2/users.json")
  request = Net::HTTP::Get.new(uri)
  # 别忘Zendesk API需要认证！用邮箱+API Token格式：邮箱/token:你的Token
  request.basic_auth "your-email@techcompany.com/token", "your-zendesk-api-token"

  response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
    http.request(request)
  end

  # 先打印响应内容，确认数据正确性
  puts response.body
  data = JSON.parse(response.body)
  puts "获取到的用户数量：#{data["users"].count}" # 看是否有数据返回
end

运行User.save_data_from_api后检查控制台：如果是HTML或错误JSON，说明认证/API地址有误；如果用户数量为0，可能是Zendesk无数据或权限不足。

第二步：用save!替代save暴露错误 #

Rails的save方法失败时仅返回false，不会抛出异常，你根本不知道哪里出问题。换成save!，一旦保存失败会直接抛出错误信息（比如必填字段缺失、数据类型不匹配）。

修改循环保存的代码：

data["users"].each do |zendesk_user|
  user = User.new(
    name: zendesk_user["name"],
    email: zendesk_user["email"],
    zendesk_id: zendesk_user["id"], # 建议存Zendesk用户ID，避免重复导入
    # 其他需要的字段，注意和User模型字段对应
  )
  user.save! # 用save!，失败直接报错
  puts "成功保存用户：#{user.name}"
rescue ActiveRecord::RecordInvalid => e
  puts "保存用户失败：#{zendesk_user["email"]}，错误：#{e.message}"
end

这样控制台会直接告诉你哪个字段有问题，比如User模型要求email唯一但重复导入了同一用户。

第三步：处理Zendesk API的分页 #

Zendesk API默认每次仅返回100条用户数据，若用户超过100个，只拉第一页会漏掉后续数据。要处理分页，需检查响应里的next_page字段：

def self.save_data_from_api
  next_page = "https://techcompany.zendesk.com/api/v2/users.json"
  
  while next_page.present?
    uri = URI.parse(next_page)
    request = Net::HTTP::Get.new(uri)
    request.basic_auth "your-email@techcompany.com/token", "your-zendesk-api-token"

    response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
      http.request(request)
    end

    data = JSON.parse(response.body)
    next_page = data["next_page"] # 获取下一页地址，无数据则为nil，循环结束

    data["users"].each do |zendesk_user|
      # 先查是否已存在用户，避免重复创建
      user = User.find_or_initialize_by(zendesk_id: zendesk_user["id"])
      user.update!(
        name: zendesk_user["name"],
        email: zendesk_user["email"],
        # 其他字段
      )
      puts "同步用户：#{user.name}"
    rescue ActiveRecord::RecordInvalid => e
      puts "同步失败：#{zendesk_user["email"]}，错误：#{e.message}"
    end
  end
end

用find_or_initialize_by可避免重复创建用户，多次运行方法也不会生成重复数据。

最后几个注意点 #

• Zendesk API权限：确保你的API Token有读取用户数据的权限，否则会返回403错误。
• 字段映射：务必保证Zendesk返回的字段与User模型字段对应，别写错字段名。
• 异常处理：除ActiveRecord错误，还要处理HTTP请求错误（比如网络超时、API返回500），可加rescue Net::HTTPError捕获这类问题。

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