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' )
-
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
，它基于适配器类型判断，不受 SQL 返回值格式干扰
ActiveRecord::Base.connection.mysql? - 注意：如果连接未建立（比如
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 条件更重要。
