RomM项目与MariaDB 11的兼容性问题分析与解决方案

问题背景

RomM是一款游戏库管理应用，在Docker环境中运行时需要依赖MariaDB作为数据库服务。近期有用户报告在部署RomM时遇到数据库连接问题，具体表现为使用MariaDB 11版本时无法建立连接，而回退到MariaDB 10版本则可以正常工作。

问题现象

当使用以下配置部署RomM时会出现连接问题：

• 使用mariadb:11或mariadb:latest镜像
• 通过Docker Compose编排服务
• 使用自定义网络（特别是Overlay网络驱动）

主要错误表现为：

1. 应用容器无法连接到数据库，提示"Host 'XXX.XXX.XXX.XXX' is not allowed to connect to this MariaDB server"
2. 即使在数据库容器内部，也无法使用配置的用户凭据登录
3. 数据库日志显示正常启动，但连接权限存在问题

根本原因分析

经过深入调查，发现问题可能由以下几个因素共同导致：

1. MariaDB 11的权限模型变更：MariaDB 11版本对用户权限管理进行了调整，可能导致容器环境下自动创建的用户权限不足。

2. 网络驱动兼容性：使用Overlay网络驱动时，容器间的连接方式可能与MariaDB 11的默认权限配置不兼容。

3. 健康检查机制：MariaDB 11的健康检查脚本可能需要额外配置才能正常工作。

4. 自动升级机制：MariaDB 11可能需要显式启用自动升级功能才能正确处理用户权限。

解决方案

针对上述问题，我们推荐以下解决方案：

方案一：降级到MariaDB 10

这是最直接的解决方案，已在多个环境中验证有效：

services:
  romm-db:
    image: mariadb:10
    environment:
      MARIADB_AUTO_UPGRADE: "true"
    healthcheck:
      timeout: 5m

关键配置说明：

• 明确指定使用mariadb:10镜像
• 设置MARIADB_AUTO_UPGRADE环境变量为true
• 调整健康检查超时时间为5分钟

方案二：使用root账户（不推荐）

如果必须使用MariaDB 11，可以尝试使用root账户：

environment:
  MARIADB_USER: root
  MARIADB_PASSWORD: ${DB_ROOT_PASSWORD}

注意：此方案存在安全隐患，仅建议在测试环境中使用。

方案三：调整网络配置

如果使用Overlay网络驱动不是必须的，可以尝试改用默认的bridge网络：

networks:
  default:
    driver: bridge

最佳实践建议

1. 版本控制：在Docker Compose文件中明确指定MariaDB版本，避免使用latest标签。

2. 权限隔离：为RomM创建专用数据库用户，避免使用root账户。

3. 健康检查：适当延长健康检查超时时间，确保数据库完全初始化。

4. 日志监控：部署后检查数据库日志，确认用户权限是否正确设置。

5. 数据备份：在版本变更前备份数据库，防止数据丢失。

总结

RomM与MariaDB 11的兼容性问题主要源于新版数据库的权限模型变更和网络配置要求。通过降级到MariaDB 10或调整相关配置，可以解决连接问题。对于生产环境，建议采用方案一，既保证稳定性又兼顾安全性。随着RomM和MariaDB的持续更新，这一问题有望在未来版本中得到根本解决。