Rails7集成Authlogic执行@user.save时触发NameError常量名错误

问题现象 #

在Rails 7项目中配置Authlogic gem，编写的UsersController代码如下：

class UsersController < ApplicationController
  def new
    render_page 'Registration'
  end

  def create
    @user = User.new(email: 'codcore@gmail.com', password: 415561)
    if @user.save
      redirect_to root_url
    else
      render_page 'Registration', props: { errors: @user.errors_codes }
    end
  end

  private

  def user_params
    params.require(:user).permit(:name, :surname, :email, :password, :password_confirmation).to_h
  end
end

对应的User模型代码如下：

class User < ApplicationRecord
  self.inheritance_column = 'there_is_no_sti_here'

  acts_as_authentic do |c|
    c.session_class = Session
    c.crypto_provider = ::Authlogic::CryptoProviders::BCrypt
  end
end

触发UsersController#create动作时抛出如下错误，错误指向@user.save行：

NameError - wrong constant name 
      Object.const_get(camel_cased_word)
            ^^^^^^^^^^:
  app/controllers/users_controller.rb:8:in `create'

该问题有个特殊表现：在rails console中创建User实例并调用save操作完全正常，无任何报错，替换Authlogic为GitHub源码版本也无法解决问题。

问题成因 #

这个问题是Rails 7默认使用的Zeitwerk自动加载机制和Authlogic配置的兼容问题：

• 你在acts_as_authentic配置块中直接使用常量Session赋值给session_class，Web请求场景下模型是懒加载的，User模型加载时Session常量可能尚未完成加载，导致Authlogic内部记录的会话类值异常，最终在save时调用const_get传入了空字符串，触发常量名错误。
• 控制台环境下启动时会预加载所有模型常量，Session在User加载前就已经存在，所以不会触发该问题。
• 另外你在创建User时传入的password参数是整数类型，虽然不是本次报错的成因，但BCrypt加密要求传入字符串，后续可能触发其他异常。

解决步骤 #

• 修改User模型中Authlogic的session_class配置，不要直接传常量，改为传字符串形式的类名，让Authlogic在需要使用时再做常量解析：

class User < ApplicationRecord
  self.inheritance_column = 'there_is_no_sti_here'

  acts_as_authentic do |c|
    # 把Session改为'Session'字符串
    c.session_class = 'Session'
    c.crypto_provider = ::Authlogic::CryptoProviders::BCrypt
  end
end

• 确认app/models/session.rb中定义的Session模型正确继承Authlogic的会话基类：

# app/models/session.rb
class Session < Authlogic::Session::Base
  authenticate_with User
end

• 修改控制器中创建User时的password参数为字符串类型，后续正式接入表单时也要注意保证传入的password是字符串格式：

# 把password: 415561改为password: '415561'
@user = User.new(email: 'codcore@gmail.com', password: '415561')

修改完成后重启Rails服务，Web请求下的用户保存逻辑就会正常运行。

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