Rails执行迁移时ar_internal_metadata表从schema消失的问题咨询

我之前处理过类似的Rails迁移坑，咱们一步步来解决你的三个疑问：

一、如何阻止ar_internal_metadata在本地迁移时被移除？ #

首先得搞清楚这个表的作用：它是Rails用来跟踪数据库schema对应环境（比如development/production）的核心内部表，正常情况下迁移时不该被移除。出现这个问题大概率是这几个原因：

• 检查schema排除配置：打开config/application.rb，看看有没有类似这样的代码：

  ActiveRecord::SchemaDumper.ignore_tables += %w(ar_internal_metadata)
  

  如果有，直接删掉这行——这会让Rails生成schema时忽略这个表，迁移时自然会把它从本地库中移除。

• 确认环境匹配：登录本地数据库，查看ar_internal_metadata表的environment字段值是不是development。如果不是，Rails会认为当前环境的schema不匹配，迁移时可能会调整这个表。你可以手动更新这条记录：

  UPDATE ar_internal_metadata SET value = 'development' WHERE key = 'environment';
  

• 验证schema格式设置：在config/environments/development.rb里，确保config.active_record.schema_format设置的是:ruby（生成schema.rb）或者:sql（生成structure.sql）。如果是:ruby，Rails默认会包含内部表；如果是:sql，要确保本地的structure.sql是从生产环境正确同步过来的，没有遗漏这个表。

二、如何恢复ar_internal_metadata表？ #

恢复这个表很简单，因为它的结构非常基础，有几种方法可选：

• 手动创建表（最直接）：打开本地数据库的终端（比如psql、mysql客户端），执行以下SQL：

  -- 创建表结构
  CREATE TABLE ar_internal_metadata (
    key character varying NOT NULL,
    value character varying,
    created_at timestamp(6) NOT NULL,
    updated_at timestamp(6) NOT NULL,
    PRIMARY KEY (key)
  );
  -- 插入环境记录
  INSERT INTO ar_internal_metadata (key, value, created_at, updated_at)
  VALUES ('environment', 'development', NOW(), NOW());
  

• 从生产环境同步：如果生产环境有这个表，可以导出它的结构和数据，再导入本地。比如PostgreSQL可以用：

  # 导出生产环境的表结构和数据
  pg_dump -t ar_internal_metadata your_production_db > ar_internal_metadata.sql
  # 导入本地数据库
  psql your_development_db < ar_internal_metadata.sql
  

• 通过schema重置（慎用）：如果本地数据库没有重要数据，可以直接执行bin/rails db:schema:load，这会根据当前schema.rb（或structure.sql）重新创建整个数据库——前提是你的schema文件里已经包含了这个表的定义。

三、直接复制粘贴表结构到schema是否可行？ #

完全可行，但要注意格式正确：

• 如果用的是schema.rb：找到其他表定义的位置，插入以下代码（确保和实际表结构一致）：

  create_table "ar_internal_metadata", force: :cascade do |t|
    t.string "value"
    t.datetime "created_at", precision: 6, null: false
    t.datetime "updated_at", precision: 6, null: false
    t.string "key", null: false
    t.index ["key"], name: "index_ar_internal_metadata_on_key", unique: true
  end
  

  插入后，执行bin/rails db:schema:dump重新生成schema.rb，确保它和本地数据库结构完全同步。

• 如果用的是structure.sql：直接复制生产环境structure.sql中关于ar_internal_metadata的表定义部分，粘贴到本地的structure.sql里即可。

不过更稳妥的做法是先恢复本地的表，再执行bin/rails db:schema:dump，让Rails自动把表结构写入schema文件，避免手动粘贴出错。

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