Sequel Ace连接MariaDB数据库的SSH隧道问题解析

问题现象

在使用Sequel Ace连接MariaDB数据库时，用户遇到了一个典型的连接拒绝错误。具体表现为：虽然能够成功连接到SSH主机，但在尝试连接数据库时出现"Access denied for user"的错误提示。错误信息显示用户'forage'@'%'被拒绝访问数据库'forage'。

技术背景

Sequel Ace作为一款macOS平台的数据库管理工具，支持通过SSH隧道连接远程MySQL/MariaDB数据库。这种连接方式通常涉及两个层面的认证：

1. SSH层面的认证（主机连接）
2. 数据库层面的认证（数据库访问）

问题分析

从错误信息可以看出，问题出在数据库访问权限层面而非SSH连接层面。具体表现为：

• SSH隧道建立成功（能连接到主机）
• 数据库认证失败（无法访问特定数据库）
• 错误信息中用户名显示为'forage'@'%'，表明连接请求来自任意主机（%通配符）

可能原因

1. 数据库用户权限配置问题：用户'forage'可能没有被授予访问'forage'数据库的权限
2. 数据库不存在：虽然错误提示中提到数据库，但实际可能已被删除
3. 密码错误：虽然错误信息未明确提示，但也是常见原因之一
4. 用户主机限制：数据库可能配置了只允许从特定主机连接

解决方案

用户最终通过重新创建数据库解决了问题，这表明原始数据库可能存在以下情况之一：

• 数据库确实不存在
• 数据库权限配置损坏
• 数据库用户权限丢失

最佳实践建议

1. 权限验证：使用命令行工具先验证数据库连接

   mysql -u forage -p -h hostname forage
   

2. 权限检查：确认用户拥有数据库访问权限

   SHOW GRANTS FOR 'forage'@'%';
   

3. 逐步排查：

   • 先确认SSH连接正常
   • 再测试数据库本地连接
   • 最后测试通过SSH隧道的连接

4. 权限配置：确保为用户分配了正确的权限

   GRANT ALL PRIVILEGES ON forage.* TO 'forage'@'%';
   FLUSH PRIVILEGES;
   

总结

数据库连接问题往往涉及多层次的配置检查。通过SSH隧道连接时，需要分别验证SSH和数据库两个层面的配置。当遇到类似问题时，建议按照从底层到高层的顺序逐步排查，先确保基础连接正常，再检查具体的数据库权限设置。对于重要的生产环境，建议定期备份和验证数据库配置，以避免类似问题的发生。