Azure Databricks创建Catalog时遇Hive MetaStore连接重置错误求助

这个错误的核心是Databricks集群无法建立到Azure MySQL元数据库的TCP连接（Connection reset），导致HiveMetaStoreClient实例化失败——这不是Hive客户端本身的问题，重点要排查网络、MySQL配置、Databricks权限三类问题。

1. 检查Azure MySQL防火墙与网络规则 #

• 确认MySQL服务器的防火墙已添加允许规则：要么放通Databricks集群所在VNet的IP段，要么添加Databricks集群的出站公网IP（如果是公网访问模式）
• 若使用VNet对等连接：确保MySQL的VNet与Databricks工作区的VNet已完成对等配置，同时MySQL的网络安全组（NSG）允许来自Databricks子网的入站3306端口流量
• 注意：Azure MySQL默认拒绝所有外部访问，必须手动配置允许规则

2. 验证MySQL连接参数正确性 #

• 检查Databricks元数据配置中的服务器地址、端口、用户名、密码是否准确：尤其是MySQL用户名必须带@服务器名称后缀（例如admin@consolidated-eastindia-prod-metastore）
• 确认MySQL是否强制SSL连接：如果是，需要在Databricks的Hive元数据配置中添加SSL相关参数（如spark.hadoop.hive.metastore.uris等配置项需包含SSL连接串）
• 查看MySQL服务器状态：确认实例处于运行状态，未出现连接数耗尽、资源过载等情况

3. 测试Databricks集群的连通性 #

在Databricks Notebook中执行以下Shell命令，直接验证与MySQL服务器的TCP连通性：

%sh nc -zv consolidated-eastindia-prod-metastore.mysql.database.azure.com 3306

或者：

%sh telnet consolidated-eastindia-prod-metastore.mysql.database.azure.com 3306

如果命令返回连接失败，说明网络层面存在阻断，优先排查防火墙、VNet配置；如果连接成功，再检查元数据配置的参数细节。

4. 确认Databricks元数据初始化状态 #

如果是新部署的Databricks工作区，要确保Azure MySQL实例已完成Hive元数据的初始化操作（比如执行过Hive的schema初始化脚本），空数据库无法支撑HiveMetaStore的正常运行

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