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 更可靠，尤其当应用用了连接池或多数据库时。

• 获取当前连接的 MySQL 版本：

  ActiveRecord::Base.connection.select_value("SELECT VERSION()")

  —— 返回字符串如 "8.0.33"

• 更稳妥的方式是用 ActiveRecord 内置方法：

  ActiveRecord::Base.connection.mariadb? # false
  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 条件更重要。

https://www.php.cn/faq/2024021.html