Strong Migrations 与 MariaDB 版本兼容性问题解析

问题现象

在使用 Strong Migrations 1.8.0 版本配合 mysql2 驱动和 MariaDB 10.4 数据库时，开发者遇到了一个版本兼容性错误提示："MariaDB version (5.7) not supported in this version of Strong Migrations (1.8.0)"。这个错误出现在运行数据库迁移时，尽管实际使用的是 MariaDB 10.4 版本。

问题根源分析

经过排查，发现问题的根本原因在于 Strong Migrations 的配置项 StrongMigrations.target_mariadb_version 被显式设置为了 5.7。这个配置项会覆盖实际的数据库版本检测，强制使用指定的版本进行兼容性检查。

技术背景

Strong Migrations 是一个用于安全执行数据库迁移的 Ruby gem，它会检查迁移操作是否可能对生产环境造成风险。为了正确执行这些检查，它需要知道目标数据库的确切版本。

当使用 MariaDB 时，Strong Migrations 会：

1. 首先尝试通过 SELECT VERSION() 获取实际数据库版本
2. 如果没有显式配置，会使用检测到的版本进行兼容性检查
3. 如果配置了 target_mariadb_version，则会优先使用配置值

解决方案

要解决这个问题，可以采取以下任一方法：

1. 移除显式版本配置：删除或注释掉 StrongMigrations.target_mariadb_version = 5.7 这行配置，让 Strong Migrations 自动检测数据库版本。

2. 更新配置为实际版本：如果确实需要显式配置，应该设置为实际的 MariaDB 版本：

   StrongMigrations.target_mariadb_version = "10.4"
   

3. 检查环境一致性：确保开发环境中所有开发者使用的配置一致，避免因配置差异导致不同开发者遇到不同行为。

最佳实践建议

1. 优先使用自动检测：除非有特殊需求，否则建议让 Strong Migrations 自动检测数据库版本，这能减少配置错误的风险。

2. 统一团队配置：将数据库版本配置放在共享的初始化文件中，确保团队成员使用相同的设置。

3. 版本兼容性检查：定期检查 Strong Migrations 版本与数据库版本的兼容性，特别是在升级数据库或 gem 时。

4. 日志记录：在初始化时记录实际使用的数据库版本，便于问题排查：

   Rails.logger.info "Using MariaDB version: #{ActiveRecord::Base.connection.select_value("SELECT VERSION()")}"
   

总结

数据库迁移工具的版本兼容性配置是一个容易被忽视但非常重要的细节。通过理解 Strong Migrations 的版本检测机制，合理配置目标数据库版本，可以避免类似问题的发生，确保数据库迁移过程的安全性和可靠性。