升级RoR 3.4.2/8.0.2后rake db:migrate报add_column参数错误求助

问题场景 #

将Ruby on Rails升级至8.0.2版本后，执行rake db:migrate时触发数据库迁移错误，报错信息如下：

...
== 20151121064619 AddUploadToEntries: migrating ===============================
-- add_attachment(:entries, :upload)
rake aborted!
StandardError: An error has occurred, this and all later migrations canceled: (StandardError)

wrong number of arguments (given 4, expected 3)
/usr/local/bundle/gems/activerecord-8.0.2/lib/active_record/connection_adapters/sqlite3_adapter.rb:338:in 'add_column'
/usr/local/bundle/gems/paperclip-6.1.0/lib/paperclip/schema.rb:27:in 'block (2 levels) in Paperclip::Schema::Statements#add_attachment'
...

涉及的迁移文件代码：

class AddUploadToEntries < ActiveRecord::Migration[8.0]
  def self.up
    add_attachment :entries, :upload
  end

  def self.down
    remove_attachment :entries, :upload
  end
end

矛盾点 #

报错提示add_column方法预期3个参数、实际传入4个，但查看sqlite3_adapter.rb第338行的add_column方法定义，明确接收4个参数（含**options），且调用该方法的Paperclip库代码确实传入了4个参数，从代码层面看参数数量并无不匹配。

原因及解决办法 #

核心原因 #

Paperclip 6.1.0 版本未适配 Rails 8.0 的 ActiveRecord 方法签名变更。Rails 8.0 对add_column方法的内部实现做了调整，虽然表面参数数量一致，但方法重载或参数处理逻辑的变化导致旧版Paperclip的调用方式触发了参数不匹配错误。

解决选项 #

• 临时修复：手动替换add_attachment调用
  放弃使用Paperclip提供的add_attachment方法，直接手动添加所需字段，修改迁移文件如下：

  class AddUploadToEntries < ActiveRecord::Migration[8.0]
    def change
      add_column :entries, :upload_file_name, :string
      add_column :entries, :upload_content_type, :string
      add_column :entries, :upload_file_size, :integer
      add_column :entries, :upload_updated_at, :datetime
    end
  
    def down
      remove_column :entries, :upload_file_name
      remove_column :entries, :upload_content_type
      remove_column :entries, :upload_file_size
      remove_column :entries, :upload_updated_at
    end
  end
  

  执行rake db:migrate即可完成迁移。

• 长远方案：迁移至Active Storage
  Paperclip已停止积极维护，后续与新版Rails的兼容性问题会持续出现。Rails内置的Active Storage是官方推荐的附件处理方案，功能完善且与Rails版本同步更新，建议逐步将项目中的Paperclip替换为Active Storage。

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