Rails执行迁移后Schema自动添加COLLATE选项如何避免？

原因 #

Rails的schema.rb是依据数据库实际表结构生成的，当数据库中表的实际collation与schema.rb记录的配置不一致时，执行迁移后Rails会同步更新schema.rb里的表配置，补上缺失的COLLATE参数。

解决方案 #

• 统一数据库默认collation与schema.rb配置
  确保MySQL数据库默认collation为utf8mb4_general_ci，让后续生成的表自动沿用该配置，避免schema.rb出现额外变更。可通过以下SQL操作：

  -- 查看数据库默认字符集和collation
  SELECT @@character_set_database, @@collation_database;
  
  -- 修改数据库默认配置（需对应权限）
  ALTER DATABASE your_database_name CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
  

• 迁移时显式指定表的options
  在创建search_logs表的迁移文件中，明确指定和现有表一致的options配置，避免Rails触发全表schema更新：

  class CreateSearchLogs < ActiveRecord::Migration[5.2]
    def change
      create_table :search_logs, options: "ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 ROW_FORMAT=DYNAMIC" do |t|
        t.timestamp :created_at
        t.string :query
        t.integer :results_count
        t.string :first_5_results
        t.string :first_result_url
      end
    end
  end
  

• 临时跳过schema.rb更新
  若只是临时不想更新schema.rb，执行迁移时添加--skip-schema-dump参数：

  rails db:migrate --skip-schema-dump
  

  注意：该方式会导致schema.rb与实际数据库结构不一致，仅适合临时场景，长期使用易引发问题。

• 手动修正并锁定配置
  确认现有表无需COLLATE配置时，手动修改schema.rb去掉新增的COLLATE参数，同时确保数据库中所有表的collation与schema.rb记录一致，后续执行迁移时Rails就不会再自动添加该参数。

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