为Devise添加Username时遭遇多类错误的技术求助

我来一步步帮你搞定这几个问题，都是用 Devise 扩展用户字段时很容易踩的坑：

第一个错误：undefined method 'for' for Devise::ParameterSanitizer #

这个问题出在 Devise 版本兼容上——你用的应该是 Devise 4.x 及以上的版本，而旧版的 devise_parameter_sanitizer.for 方法已经被弃用，官方换成了更符合 Rails 强参数规范的 permit 写法。把 application_controller.rb 里的代码改成下面这样：

before_action :configure_permitted_parameters, if: :devise_controller?

protected

def configure_permitted_parameters
  # 注册时允许的参数
  devise_parameter_sanitizer.permit(:sign_up, keys: [:username, :email, :password, :password_confirmation, :remember_me])
  # 登录时允许的参数（如果没用到:login可以直接删掉）
  devise_parameter_sanitizer.permit(:sign_in, keys: [:login, :username, :email, :password, :remember_me])
  # 更新账户时允许的参数
  devise_parameter_sanitizer.permit(:account_update, keys: [:username, :email, :password, :password_confirmation, :current_password])
end

第二个错误：undefined method 'username_field' #

你在 Devise 视图里写的 <%= f.username_field :username ... %> 是错的——Rails 表单 helper 里根本没有 username_field 这个方法！用户名属于普通文本输入，换成 text_field 就好了：

<%= f.text_field :username, :autofocus => true, autocomplete: "username" %>

第三个错误：LoadError cannot load such file -- bcrypt_ext #

这个是 bcrypt gem 的原生扩展编译失败导致的，按下面步骤修复：

1. 先卸载已安装的 bcrypt：

   gem uninstall bcrypt
   

2. 强制以 Ruby 平台重新安装，触发原生扩展编译：

   gem install bcrypt --platform=ruby
   

3. 最后更新项目依赖：

   bundle install
   

如果还是不行，可以试试在 Gemfile 里指定一个兼容性较好的 bcrypt 版本，比如：

gem 'bcrypt', '3.1.16'

然后运行 bundle update bcrypt 再重复上面的安装步骤。

按这三个步骤操作，应该就能顺利完成 Devise 用户名的自定义啦！

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