使用Rails Migration无法创建数据库的问题求助

我运行rails db:migrate命令时出了问题，迁移代码如下：

class CreateAdmins < ActiveRecord::Migration[7.0]
  def change
    create_table :admins do |t|

      t.string :email, limit: 50
      t.string :encrypted_password, limit: 100
      t.integer :sign_in_count, default: 0
      t.string :hashid1, limit: 100
      t.string :hashid2, limit: 100
      t.string :encrypted_fullname_vi, limit: 100
      t.string :encrypted_fullname_en, limit: 100
      t.string :encrypted_birthday, limit: 100
      t.string :encrypted_address, limit: 100
      t.string :nickname
      t.json :image_json
      t.integer :show_avatar, limit: 1, default: 0

      t.timestamps
    end
  end
end

试过论坛里各种方法都没解决，我的环境：Ruby 3.1.4、Rails 7.0.8、Migration 7.0

实用排查解决步骤 #

1. 修正integer字段的limit设置 #

如果用的是MySQL，t.integer :show_avatar, limit: 1会被映射成tinyint，但Rails和MySQL的类型映射偶尔会出问题。直接改成明确的类型试试：

t.tinyint :show_avatar, default: 0

2. 检查JSON字段的数据库兼容性 #

• 要是用的MySQL版本低于5.7，原生不支持JSON类型，把t.json :image_json换成t.text :image_json，或者升级MySQL到5.7及以上版本。
• 用PostgreSQL的话，确保数据库版本和Rails 7兼容，一般9.4+就支持JSON类型。

3. 确认迁移文件与数据库连接 #

• 检查迁移文件名是否符合[时间戳]_create_admins.rb的格式，拼写错误会导致Rails无法识别。
• 核对config/database.yml里的数据库配置，确认数据库服务正常运行，当前用户有创建表的权限。可以先执行rails db:create确保数据库存在，或者备份数据后执行rails db:drop && rails db:create && rails db:migrate重置。

4. 清理迁移状态与缓存 #

• 执行rails db:migrate:status查看迁移状态，若有失败记录，先执行rails db:rollback回滚，再重新迁移。
• 可以删除db/schema.rb后重新执行rails db:migrate（操作前务必备份数据）。

5. 适配数据库适配器版本 #

检查Gemfile里的数据库适配器版本，比如mysql2是否和Rails 7.0.8兼容。尝试更新或指定兼容版本：

bundle update mysql2

或者在Gemfile里指定：

gem 'mysql2', '~> 0.5.5'

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