ActiveRecord 支持 MySQL 但需正确配置 mysql2 驱动、adapter 设置、MySQL 版本及认证插件兼容性,并适配严格模式与 SQL mode 差异,否则易现连接失败、乱码、事务异常等问题。
ActiveRecord 完全支持 MySQL,但“支持”不等于“开箱即用无坑”——它依赖底层驱动、连接配置和 SQL 行为兼容性,

mysql2 是 Ruby ActiveRecord 连接 MySQL 的事实标准驱动Ruby 的 ActiveRecord 默认不自带数据库驱动,必须显式安装并指定 mysql2 适配器。跳过这步或误用 mysql(已废弃)会导致 LoadError: cannot load such file -- mysql 或连接时静默失败。
gem install mysql2,并在
Gemfile 中声明 gem 'mysql2',再运行 bundle install
adapter: 'mysql2',不能只写 mysql;Rails 项目中统一在 config/database.yml 设置,独立使用时调用:ActiveRecord::Base.establish_connection( adapter: 'mysql2', host: 'localhost', username: 'root', password: '123', database: 'myapp_development' )
mysql2 0.5+ 要求 MySQL 5.6+,若连的是 MySQL 8.0+,还需确认服务端默认认证插件是 caching_sha2_password 还是 mysql_native_password;后者更兼容,必要时在 MySQL 中执行:ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY '123';
ActiveRecord::Base.connection 能查出真实 MySQL 版本,但别信 SELECT VERSION() 的返回格式ActiveRecord 封装了底层连接,直接调用 connection 对象比手写 SQL 更可靠,尤其当应用用了连接池或多数据库时。
ActiveRecord::Base.connection.select_value("SELECT VERSION()") —— 返回字符串如 "8.0.33"
ActiveRecord::Base.connection.mariadb? # false,它基于适配器类型判断,不受 SQL 返回值格式干扰
ActiveRecord::Base.connection.mysql?
establish_connection 没调用或失败),访问 connection 会抛 ActiveRecord::ConnectionNotEstablished,务必先确保连接就绪STRICT_TRANS_TABLES)会让 ActiveRecord 的隐式插入/更新直接报错ActiveRecord 默认不校验字段长度、空值约束等,全交给数据库把关。MySQL 开启严格模式后,NULL 插入非空字段、超长字符串截断等操作会变成硬错误,而非静默处理。
Mysql2::Error: Data too long for column 'name' at row 1或
Field 'created_at' doesn't have a default value
validates_presence_of 或 validates_length_ofchange_column_default :users, :status, from: nil, to: 0
t.datetime :created_at, null: false, default: -> { "CURRENT_TIMESTAMP" }
database.yml 的 variables 下加配置临时绕过(仅限调试):variables: { sql_mode: "NO_ENGINE_SUBSTITUTION" },但上线前必须清理掉真正麻烦的从来不是“能不能连上”,而是“连上之后行为是否一致”——比如 MySQL 的 GROUP BY 语义、时区处理、JSON 字段映射、甚至小数点精度舍入方式,都会让 ActiveRecord 的同一段 Ruby 代码在不同 MySQL 版本或配置下表现迥异。动手前先确认你的 MySQL 实例实际启用了哪些 SQL mode,比写十个 where 条件更重要。