如何创建指定COLLATE的数据库迁移?解决MySQL版本兼容问题
当然可以指定Collation!这个问题我之前也碰到过——MySQL 8.0把utf8mb4的默认排序规则改成了utf8mb4_0900_ai_ci,但旧版本MySQL(比如5.7及更早)根本不认识这个规则,所以才会出现跨环境的报错。下面给你几个可行的解决办法:
1. 在database.yml中直接指定全局Collation
这是最简单的方式,直接在各个环境的数据库配置里添加collation参数,指定一个新旧版本都支持的规则,比如utf8mb4_unicode_ci或者utf8mb4_general_ci(后者性能稍好但排序精度略低,根据你的需求选):
development: adapter: mysql2 encoding: utf8mb4 collation: utf8mb4_unicode_ci database: your_db_name username: root password: your_password host: localhost test: adapter: mysql2 encoding: utf8mb4 collation: utf8mb4_unicode_ci # 其他测试环境配置... production: adapter: mysql2 encoding: utf8mb4 collation: utf8mb4_unicode_ci # 其他生产环境配置...
配置完后,重新运行迁移或者生成schema.rb,新的create_table语句就会使用你指定的Collation,而不是MySQL8的默认值。
2. 在迁移文件中显式指定表的Collation
如果只需要针对特定表调整,或者想在迁移里明确控制,可以在create_table的options里直接写好Collation:
create_table "tasks", id: :integer, options: "ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci", force: :cascade do |t| t.string "name" t.text "description" # 其他字段... end
这种方式适合需要精细控制的场景,确保每个表的Collation都符合兼容要求。
3. 配置ActiveRecord默认Collation(全局生效)
如果想让所有生成的表都默认使用指定的Collation,可以在Rails的初始化文件里添加配置:
在config/initializers/active_record.rb中加入:
ActiveRecord::ConnectionAdapters::Mysql2Adapter.default_collation = 'utf8mb4_unicode_ci'
这样ActiveRecord在生成schema.rb或者执行迁移时,就会自动使用你设置的默认Collation,不用每个地方都手动写。
最后要做的事
修改完配置后,记得重新生成schema.rb(可以跑一遍rails db:schema:dump),然后把新的schema文件同步到CI和生产环境,再测试迁移是否正常运行——这样就能避免Unknown collation的报错了。
内容的提问来源于stack exchange,提问作者Kris

