Java应用连接HeidiSql及JHipster应用数据库连接故障求助

HeidiSQL是MySQL/MariaDB的可视化管理工具，Java应用本质是连接它背后的MySQL数据库，具体操作步骤如下：

1. 添加MySQL驱动依赖
   如果你用Maven管理项目，在pom.xml中加入驱动依赖：

   <dependency>
       <groupId>mysql</groupId>
       <artifactId>mysql-connector-java</artifactId>
       <version>8.0.33</version> <!-- 建议使用最新稳定版 -->
   </dependency>
   

   注意：如果你的MySQL版本是8.x及以上，官方已经废弃了旧版驱动类com.mysql.jdbc.Driver，需要改用com.mysql.cj.jdbc.Driver。

2. 编写数据库连接代码
   参考示例代码，配置要和HeidiSQL中使用的数据库地址、端口、账号密码保持一致：

   import java.sql.Connection;
   import java.sql.DriverManager;
   import java.sql.SQLException;
   
   public class DBConnector {
       public static void main(String[] args) {
           String url = "jdbc:mysql://localhost:3306/your_db_name?useSSL=false&serverTimezone=UTC";
           String user = "your_username";
           String password = "your_password";
   
           try (Connection connection = DriverManager.getConnection(url, user, password)) {
               System.out.println("成功连接到数据库！");
           } catch (SQLException e) {
               System.out.println("连接失败：" + e.getMessage());
           }
       }
   }
   

既然代码在其他环境能正常运行，问题大概率出在当前机器的环境或网络层面，按以下步骤逐一排查：

1. 先确认网络连通性 #

• 用ping命令测试数据库服务器可达性：ping 11.333.34.65，如果不通，说明当前机器和数据库服务器之间有网络隔离（比如未连接指定VPN、公司内网限制、服务器防火墙拦截）。
• 再用telnet测试端口是否开放：telnet 11.333.34.65 3306，如果连接失败，基本可以确定是3306端口未对当前机器开放，需要联系数据库管理员调整防火墙规则。

2. 检查数据库账号的IP访问权限 #

MySQL账号默认可能限制了访问IP，即使密码正确，当前机器IP不在允许范围内也会连接失败。你可以用能正常连接的机器登录HeidiSQL，执行以下SQL检查权限：

SELECT user, host FROM mysql.user WHERE user = 'hello';

如果host列显示的是localhost或特定IP段，而当前机器IP不在其中，就需要更新权限：

GRANT ALL PRIVILEGES ON some_name.* TO 'hello'@'%' IDENTIFIED BY 'hello';
FLUSH PRIVILEGES;

（注：%表示允许所有IP访问，生产环境建议替换为具体IP段，提升安全性）

3. 验证驱动版本与数据库兼容性 #

你的配置中使用了旧版驱动com.mysql.jdbc.Driver，如果数据库服务器是MySQL 8.x，当前机器的驱动版本过低会导致连接失败。建议：

• 升级MySQL驱动到8.x版本
• 将驱动类改为com.mysql.cj.jdbc.Driver
• 在URL中添加时区参数：jdbc:mysql://11.333.34.65:3306/some_name?serverTimezone=UTC&useSSL=false

4. 排查本地代理或DNS问题 #

• 如果当前机器开启了代理服务器，可能会干扰数据库连接，尝试关闭代理后再测试。
• 检查本地DNS是否能正确解析数据库服务器地址，或者直接在hosts文件中添加IP映射：11.333.34.65 mysql-server，然后把URL改为jdbc:mysql://mysql-server:3306/some_name试试。

5. 检查本地防火墙或安全软件 #

当前机器的防火墙（比如Windows Defender防火墙、Linux iptables）或安全软件可能拦截了Java程序访问3306端口。可以临时关闭防火墙测试，如果能连接成功，就需要给Java应用添加允许访问的规则。

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