已装MySQL Connector的C#应用在其他机器无法连MySQL如何解决

核心问题定位与修复步骤 #

1. 修正连接字符串错误 #

你当前使用的连接字符串存在致命配置错误：

• server=localhost中的localhost指向运行程序的设备本身，你在开发机运行时，程序访问的是开发机本地的MySQL服务，自然正常；部署到其他机器后，localhost就变成了目标机器自身，目标机器上没装MySQL服务的话必然连接失败。
• 当前连接字符串缺失必填配置项：没有指定目标数据库名、root账号密码。

修正后的连接字符串参考如下：

// 将<MySQL服务器IP>替换为部署MySQL服务的设备实际可访问IP，<数据库名>替换为业务使用的库名，<密码>替换为root账号的实际密码
string ConnectionString = "server=<MySQL服务器IP>;uid=root;pwd=<密码>;database=<数据库名>;charset=utf8;";

注意：MySQL服务所在设备需要放开3306端口的防火墙入站规则；默认root账号仅允许本机登录，需要提前给root账号开放远程访问权限。

2. 解决版本不兼容问题 #

你当前使用的组件版本存在严重兼容性问题：

• MySQL Connector/NET 8.0.29为8.x系列大版本驱动，官方兼容的最低MySQL Server版本为5.7，完全不支持你使用的6.3.3版本MySQL Server，跨大版本驱动调用会出现握手失败、认证不兼容等连接错误。

可二选一解决：

• 方案一：将开发环境、部署环境的MySQL Connector/NET全部替换为和MySQL Server 6.3.3匹配的6.3.x版本，重新引用编译后部署
• 方案二：升级MySQL Server到5.7/8.0版本，和现有8.0.29版本驱动匹配

3. 修复部署依赖问题 #

不要依赖目标机器全局安装的Connector/NET，避免全局GAC版本不匹配导致驱动加载失败：

• 在Visual Studio的解决方案资源管理器中，找到引用列表里的MySql.Data，右键打开属性面板，将「复制本地」选项设置为True，编译后MySql.Data.dll会自动生成到程序输出目录，部署时将该dll和主程序放在同一目录即可，无需目标机器单独安装Connector/NET。
• 匹配目标平台：目标机器为Win7 x86系统，需要打开项目属性-生成页面，将目标平台从默认的「Any CPU」修改为x86，避免平台位数不匹配导致驱动加载失败。
• 确认目标机器已安装项目依赖的对应版本.NET Framework，Win7系统默认未预装.NET 4.5及以上版本，缺少对应框架也会导致数据库组件加载失败。

4. 前置连通性验证 #

在目标机器上先做网络连通性验证，排除网络层面问题：在目标机器命令行执行telnet <MySQL服务器IP> 3306，如果端口不通先排查防火墙、路由、MySQL服务绑定地址等问题，再运行程序测试。

内容的提问来源于stack exchange，提问作者M.Shahab Taheri