Rails模型创建新记录时默认值被忽略问题求助

先还原下你的场景：你写了这样的迁移文件来创建messages表，给seen字段设置了default: false：

class CreateMessages < ActiveRecord::Migration[6.0]
  def change
    create_table :messages do |t|
      t.text :body
      t.references :conversation, null: false, foreign_key: true
      t.references :user, null: false, foreign_key: true
      t.boolean :seen, default: false
      t.timestamps
    end
  end
end

但执行Message.create(conversation_id: 1, body: "something new!", user_id: 1)后，seen的值却是nil，不是预期的false。我来帮你分析原因和解决办法：

最常见的原因：迁移没有正确同步到数据库 #

Rails的迁移是增量式的——一旦你运行过rails db:migrate，之后修改已执行的迁移文件不会自动更新数据库结构。如果你是先运行了迁移，之后才给seen字段加上default: false，那数据库里的seen字段其实根本没有设置默认值，这就会导致新创建的记录该字段为nil。

解决办法分两种情况： #

1. 如果这个迁移是最近刚执行的，还没有其他依赖数据：
   先回滚迁移，再重新执行：

   rails db:rollback
   rails db:migrate
   

   这样数据库里的seen字段就会带上default: false的设置了。

2. 如果迁移已经运行很久，不能回滚（会丢失或影响现有数据）：
   生成一个新的迁移来修改seen字段的默认值：

   rails generate migration AddDefaultToMessagesSeen
   

   打开生成的迁移文件，修改成下面这样：

   class AddDefaultToMessagesSeen < ActiveRecord::Migration[6.0]
     def change
       # 给字段设置默认值
       change_column_default :messages, :seen, false
       # 可选：把数据库中已有的nil值批量更新为false，避免旧数据不一致
       Message.where(seen: nil).update_all(seen: false)
     end
   end
   

   然后运行迁移：

   rails db:migrate
   

其他可能的排查方向 #

如果上面的方法没用，再检查这两点：

• 模型回调干扰：虽然数据库默认值应该在插入时自动生效，但如果你的Message模型里有before_save之类的回调，不小心把seen设为了nil，那也会覆盖默认值。比如检查模型里有没有类似这样的代码：

  before_save :reset_seen
  def reset_seen
    self.seen = nil
  end
  

  如果有，删掉或者调整逻辑就行。
• 验证数据库字段设置：可以在Rails控制台里直接查看字段的默认值，确认数据库层面是否生效：

  Message.columns_hash['seen'].default
  

  如果返回false，说明数据库设置没问题，再创建新消息就会有正确的默认值了。

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