如何根据配置动态添加has_one_attached关联？

问题背景 #

开发Ruby gem时，希望通过配置项config.qrcode = :active_storage，动态给CryptocoinPayable::CoinPayment模型添加has_one_attached :qrcode关联，但原代码因加载时机和配置引用错误导致失败：

1. 直接在模型中判断CryptoCoinPayable::Configuration.qrcode时，配置类未初始化，报错CryptocoinPayable::Configuration is nil
2. 调整到Railtie的:after_initialize钩子后，因判断条件错误，报错“qrcode是未定义方法”

核心错误点 #

1. 配置引用错误：原代码中CryptocoinPayable.configuration == :qrcode是将配置实例与符号比较，正确应为判断configuration.qrcode == :active_storage
2. 加载时机问题：模型加载早于Rails初始化配置，直接在模型中写条件判断会导致配置未就绪

解决方案 #

1. 修正配置类实现（确保全局实例正确） #

确保config.rb中配置类提供全局可访问的实例：

module CryptocoinPayable
  class Configuration
    attr_accessor :qrcode

    def initialize
      @qrcode = nil # 默认不启用二维码功能
    end
  end

  class << self
    attr_accessor :configuration

    def configure
      self.configuration ||= Configuration.new
      yield(configuration)
    end
  end
end

2. 调整Railtie逻辑，动态添加关联 #

修改Railtie代码，确保在所有初始化完成后，根据配置动态给模型添加关联：

module CryptocoinPayable
end

if defined?(Rails)
  module CryptocoinPayable
    class Railtie < Rails::Railtie
      # 确保配置实例被初始化
      initializer 'cryptocoin_payable.setup_config' do
        CryptocoinPayable.configure {} unless CryptocoinPayable.configuration
      end

      # 在Rails初始化完成后处理Active Storage关联
      initializer 'cryptocoin_payable.active_storage_integration' do
        ActiveSupport.on_load(:after_initialize) do
          # 确保模型已加载，且配置启用了active_storage
          if defined?(CryptocoinPayable::CoinPayment) && 
             CryptocoinPayable.configuration.qrcode == :active_storage
            CryptocoinPayable::CoinPayment.class_eval do
              has_one_attached :qrcode
            end
          end
        end
      end

      rake_tasks do
        path = File.expand_path(__dir__)
        Dir.glob("#{path}/tasks/**/*.rake").each { |f| load f }
      end
    end
  end
end

require 'cryptocoin_payable/config'
require 'cryptocoin_payable/errors'
require 'cryptocoin_payable/version'
require 'cryptocoin_payable/adapters'

3. 清理模型中的条件代码 #

将CoinPayment模型中的条件判断移除，只保留基础代码：

class CryptocoinPayable::CoinPayment < ActiveRecord::Base
  # 基础模型逻辑（无需关联代码，由Railtie动态添加）
end

关键说明 #

• 使用:after_initialize钩子：确保Rails所有初始化流程（包括用户的配置初始化）完成后，再处理模型关联
• 用class_eval动态添加方法：避免提前加载模型导致的配置未就绪问题
• 增加defined?判断：防止模型未加载时出现NameError

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