Rails 5中Devise创建用户时未将Username写入数据库问题

我之前在项目里也碰到过一模一样的问题！你遇到的核心矛盾其实是Devise默认不会自动放行你新增的自定义字段参数——哪怕你在模型里加了presence: true验证、数据库也加了非空约束，请求里的username参数会被Devise的强参数机制过滤掉，导致最终存入数据库时username是nil，直接触发PostgreSQL的非空约束报错。

第一步：配置Devise的参数白名单 #

这是最关键的一步，你需要告诉Devise允许username参数通过。有两种常见方式：

方式1：全局配置（在ApplicationController中）

在app/controllers/application_controller.rb里添加以下代码：

class ApplicationController < ActionController::Base
  # 只在Devise控制器生效时执行参数配置
  before_action :configure_permitted_parameters, if: :devise_controller?

  protected

  def configure_permitted_parameters
    # 注册时允许username参数
    devise_parameter_sanitizer.permit(:sign_up, keys: [:username])
    # 如果需要在用户编辑页面也允许修改username，再加下面这行
    devise_parameter_sanitizer.permit(:account_update, keys: [:username])
  end
end

方式2：自定义注册控制器（更灵活）

如果你需要对注册流程做更多自定义，可以新建一个注册控制器：

1. 创建app/controllers/registrations_controller.rb：

class RegistrationsController < Devise::RegistrationsController
  private

  # 注册时允许的参数
  def sign_up_params
    params.require(:user).permit(:username, :email, :password, :password_confirmation)
  end

  # 账号更新时允许的参数
  def account_update_params
    params.require(:user).permit(:username, :email, :password, :password_confirmation, :current_password)
  end
end

2. 在config/routes.rb里指定使用这个自定义控制器：

devise_for :users, controllers: { registrations: 'registrations' }

第二步：检查模型验证的正确性 #

确保你的app/models/user.rb里的验证代码是正确的，并且放在Devise模块调用之后：

class User < ApplicationRecord
  devise :database_authenticatable, :registerable,
         :recoverable, :rememberable, :validatable

  # 验证username必填，建议同时加唯一性避免重复
  validates :username, presence: true, uniqueness: true
end

这里要注意：如果你的验证写在了Devise模块之前，可能会出现验证不生效的情况，一定要放在devise :xxx之后。

第三步：确认数据库迁移的有效性 #

检查你的迁移文件（比如db/migrate/xxxxxx_add_username_to_users.rb）是否正确添加了非空约束：

class AddUsernameToUsers < ActiveRecord::Migration[5.2]
  def change
    add_column :users, :username, :string, null: false
    # 建议添加唯一索引，和模型的唯一性验证对应
    add_index :users, :username, unique: true
  end
end

并且已经执行过rails db:migrate，确保数据库表结构已经更新。

关于你提到的“模型验证通过但数据库报错”的疑问 #

正常情况下，如果username是nil，模型的presence: true验证应该会直接失败，不会走到数据库写入那一步。出现这种情况大概率是因为：

• 你在控制台创建用户时，根本没传入username参数（比如User.create!(email: 'test@xxx.com', password: '123456')），这时候模型验证应该抛出错误，但如果没抛出，可能是模型里的验证代码写错了（比如拼写错误presense）；
• 表单提交时，username参数被过滤，导致User实例的username是nil，但模型验证没触发——这种情况只要配置好参数白名单就能解决。

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