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' )
mysql20.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 更可靠，尤其当应用用了连接池或多数据库时。 获取当前连接的 MySQL 版本：
ActiveRecord::Base.connection.select_value("SELECT VERSION()") —— 返回字符串如 "8.0.33"更稳妥的方式是用 ActiveRecord 内置方法：
ActiveRecord::Base.connection.mariadb? # false<br>ActiveRecord::Base.connection.mysql?，它基于适配器类型判断，不受 SQL 返回值格式干扰 注意：如果连接未建立（比如
establish_connection没调用或失败），访问
connection会抛
ActiveRecord::ConnectionNotEstablished，务必先确保连接就绪
MySQL 的严格模式（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解决方向不是关 MySQL 严格模式（不推荐），而是让 ActiveRecord 主动适配：
• 在模型中定义
validates_presence_of或
validates_length_of
• 使用迁移文件显式设默认值：
change_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条件更重要。
