GitHub Actions中MariaDB容器启动失败排查求助

关于日志中的警告：不影响容器启动 #

你提到的两条警告属于MariaDB在--skip-name-resolve模式下的正常提示，不会导致容器启动失败：

• 忽略用户条目警告：启用--skip-name-resolve后，MariaDB无法解析主机名，因此会跳过所有基于主机名定义的数据库用户（例如user@example.com），但服务会正常启动并使用基于IP或localhost的用户。
• 代理权限条目警告：同理，代理权限配置中涉及主机名的部分会被跳过，仅影响特定权限场景，不阻碍服务运行。

容器启动失败的可能原因 #

以下是需要重点排查的几个方向：

1. 环境变量配置缺失或错误 #

MariaDB容器依赖核心环境变量完成初始化，若未正确设置可能导致服务异常：

• 必须配置MYSQL_ROOT_PASSWORD、MYSQL_DATABASE（Rails测试需要的数据库名）；如果使用非root用户连接，还需设置MYSQL_USER和MYSQL_PASSWORD。
• 避免在变量值中使用未转义的特殊字符（如#、!），可能导致初始化脚本执行异常。

2. 未等待数据库完全就绪 #

GitHub Actions中，Rails测试可能在MariaDB容器启动但未完全就绪时就发起连接，导致误判容器启动失败。可以在工作流中添加等待逻辑：

- name: Wait for MariaDB
  run: |
    until mysqladmin ping -h localhost -u ${{ secrets.MYSQL_USER }} -p${{ secrets.MYSQL_PASSWORD }} --silent; do
      echo "Waiting for MariaDB..."
      sleep 2
    done

3. 镜像版本兼容性问题 #

mariadb:latest可能引入了与Rails 7.0的mysql2 gem不兼容的特性（如默认认证插件变更为caching_sha2_password），可以尝试：

• 指定稳定版本镜像（如mariadb:10.11）；
• 添加环境变量MYSQL_DEFAULT_AUTH=mysql_native_password强制使用旧认证插件。

4. 健康检查配置不合理 #

若工作流中配置了容器健康检查，不合理的检查规则可能导致GitHub Actions误判容器未就绪：

• 确保健康检查命令正确：test: ["CMD", "mysqladmin", "ping", "-h", "localhost", "-u", "root", "-p${{ secrets.MYSQL_ROOT_PASSWORD }}"]
• 设置足够的start-period（如30秒）和retries（如5次），给MariaDB足够的初始化时间。

5. Runner资源限制 #

GitHub Actions的默认Runner内存有限，MariaDB启动时若内存不足可能静默崩溃。可以尝试：

• 在工作流中为MariaDB容器分配更多内存（若使用Docker Compose，可通过mem_limit配置）；
• 调整MariaDB的配置参数，降低内存占用（如在my.cnf中设置innodb_buffer_pool_size=256M）。

内容的提问来源于stack exchange，提问作者Edward Caulfield