Rails 5.1：旧Rails Schema引发的外键不匹配问题

这问题我之前帮朋友排查过，核心原因就是Rails版本间主键类型的差异——Rails 5.1默认用bigint做主键，而你的Rails 4.0旧项目用的是int类型，外键关联时类型不匹配就会触发报错。下面给你几个可行的解决思路：

方案一：统一旧项目的主键/外键类型为bigint（推荐长期方案） #

如果旧项目还在维护，或者你希望新旧项目的数据库结构保持一致，建议先在Rails 4.0项目中做类型迁移：

• 生成迁移文件，修改目标表的主键和关联外键类型：

  class UpdateKeyTypesToBigint < ActiveRecord::Migration
    def change
      # 示例：修改users表的主键为bigint
      change_column :users, :id, :bigint, null: false, auto_increment: true
      # 修改关联表的外键字段，比如posts表的user_id
      change_column :posts, :user_id, :bigint
      # 其他有外键关联的表依次处理
    end
  end
  

• 运行迁移：rake db:migrate
• 重新生成schema.rb：rake db:schema:dump
  之后把这个更新后的schema.rb加载到Rails 5.1项目中，类型就完全匹配了。

方案二：让Rails 5.1项目默认使用int主键（临时兼容方案） #

如果只是临时复用旧模型，不想改动旧项目的结构，可以强制Rails 5.1生成的模型都用integer类型主键：
在config/application.rb中添加配置：

module YourAppName
  class Application < Rails::Application
    # 其他配置...
    config.generators do |g|
      g.orm :active_record, primary_key_type: :integer
    end
  end
end

注意：这个配置会影响新项目所有模型的主键类型，如果未来数据量增长到超过int的存储上限（约21亿），会出现问题，适合短期兼容场景。

方案三：加载schema时动态修正类型 #

如果不想修改旧项目也不想改新项目全局配置，可以写个辅助脚本，在加载schema.rb前替换类型定义：
比如在测试加载脚本中，读取schema.rb内容后，把所有t.integer :id替换成t.bigint :id，或者反过来（根据你的匹配需求调整），再执行修改后的schema内容。

额外注意点 #

• 不同数据库的类型修改语法略有差异：比如MySQL需要指定auto_increment，PostgreSQL则不用，迁移时要适配你的数据库类型。
• 外键约束需要确保两端类型完全一致，包括是否有符号、长度等细节。

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