使用Devise Gem时ActiveRecord::Base保存出现undefined method `delete_if' for String错误的排查与解决求助

问题根源分析 #

这个报错的核心原因是Devise（大概率是devise-jwt模块）期望tokens字段是Hash/JSON类型，但服务器上的user1实例的tokens被存储成了String类型。

Devise在处理用户保存逻辑时，会对tokens执行Hash专属的delete_if方法（比如清理过期令牌），当字段实际是String时，自然会抛出undefined method 'delete_if' for #<String>的错误，进而触发事务回滚。而本地环境没有这个问题，是因为本地数据库的tokens字段都是符合要求的类型，没有脏数据。

如何获取更多异常信息 #

要精准定位问题，可以通过以下方式收集更多信息：

• 打印字段类型和值：在服务器环境的代码中，save前添加调试输出（用Rails日志而非puts，避免影响生产环境）：

  Rails.logger.info "User #{user1.id} tokens: value=#{user1.tokens}, type=#{user1.tokens.class}"
  user1.save
  

  查看服务器日志就能明确tokens的实际类型和内容。
• 直接检查数据库：通过数据库客户端执行查询，查看该用户的tokens存储值：

  SELECT id, tokens FROM users WHERE id = [user1的ID];
  

• 捕获完整错误栈：用异常捕获包裹save操作，输出完整回溯，定位Devise内部触发错误的代码位置：

  begin
    user1.save!
  rescue => e
    Rails.logger.error "Failed to save user #{user1.id}: #{e.message}"
    Rails.logger.error "Backtrace:\n#{e.backtrace.join("\n")}"
  end
  

修复方案 #

临时修复（针对单个异常用户） #

就像你发现的那样，手动将tokens重置为合法的Hash或nil即可解决单个用户的问题：

user1.tokens = {} # 推荐用空Hash，符合Devise的预期格式
user1.save!

彻底修复（解决根源，避免复发） #

1. 确保数据库字段类型正确
   检查users表的tokens字段类型，应该是json/jsonb（PostgreSQL）或json（MySQL）。如果之前的迁移错误地使用了string/text类型且未配置序列化，需要生成迁移修改字段：

   # 生成迁移文件
   rails generate migration ChangeTokensTypeInUsers
   

   编辑迁移文件：

   class ChangeTokensTypeInUsers < ActiveRecord::Migration[6.1]
     def change
       # PostgreSQL用jsonb，MySQL用json
       change_column :users, :tokens, :jsonb, default: {}, null: false
     end
   end
   

   执行迁移：rails db:migrate

2. 批量修复现有脏数据
   写一个Rake脚本，遍历所有用户，将类型为String的tokens转换为合法的Hash（或空Hash）：

   # lib/tasks/fix_user_tokens.rake
   namespace :users do
     desc "Fix invalid String-type tokens in users table"
     task fix_tokens: :environment do
       User.find_each do |user|
         next unless user.tokens.is_a?(String)
         begin
           # 尝试解析字符串为JSON，失败则设为空Hash
           cleaned_tokens = JSON.parse(user.tokens)
           user.update!(tokens: cleaned_tokens)
           Rails.logger.info "Fixed user #{user.id}: parsed tokens from String to Hash"
         rescue JSON::ParserError
           user.update!(tokens: {})
           Rails.logger.info "Fixed user #{user.id}: reset invalid String tokens to empty Hash"
         end
       end
     end
   end
   

   在服务器上执行脚本：rake users:fix_tokens

3. 验证Devise配置
   确保devise-jwt的配置正确，没有自定义逻辑篡改tokens类型：

   # config/initializers/devise.rb
   Devise.setup do |config|
     config.jwt do |jwt|
       jwt.token_store :database # 确保使用数据库存储令牌
       jwt.secret_key = Rails.application.credentials.devise_jwt_secret_key!
       # 其他JWT配置...
     end
   end
   

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