DotNet程序Linux环境下连接MySQL（端口80）失败排查咨询

碰到这种跨平台的连接问题，咱们一步步剥丝抽茧排查：

一、先搞定系统层面的核心限制 #

1. 特权端口的权限问题 #

Linux里1-1024的端口属于特权端口，只有root用户才能让服务绑定到这些端口。如果你的MySQL服务器部署在Linux上且改成了80端口：

• 先确认MySQL是不是以root身份启动的，普通用户根本没法监听80端口，自然连不上；
• 要是不想用root启动MySQL，建议把端口换成1024以上的非特权端口（比如33060），普通用户就能正常监听了。

2. 检查端口是否被占用 #

80是HTTP服务的默认端口，大概率会被Nginx、Apache这类Web服务器占用。用下面的命令查看80端口的监听进程：

# Linux通用命令，查看80端口占用
ss -tulpn | grep :80
# 或者用netstat（部分系统需先装net-tools）
netstat -tulpn | grep :80

如果输出里有nginx或httpd这类进程，说明端口被占了，要么停掉对应服务，要么给MySQL换个端口。

3. 防火墙/SELinux的拦截排查 #

Linux防火墙默认可能只放开80端口的HTTP流量，拦截MySQL协议：

• 临时关闭防火墙测试：
  CentOS/RHEL系列：sudo systemctl stop firewalld
  Ubuntu/Debian系列：sudo ufw disable
  要是关闭后能连上，就给防火墙添加允许MySQL通过80端口的规则：

  # CentOS/RHEL
  sudo firewall-cmd --add-port=80/tcp --permanent
  sudo firewall-cmd --reload
  # Ubuntu/Debian
  sudo ufw allow 80/tcp
  

• SELinux拦截测试：
  临时关闭SELinux：sudo setenforce 0，如果能连接，就配置SELinux允许MySQL用80端口：

  sudo semanage port -a -t mysqld_port_t -p tcp 80
  

二、再排查代码里的隐藏bug #

1. SslMode的类型不匹配问题 #

你有没有注意到？cred.json里的SslMode是布尔值false，但Cred类里的SslMode是字符串类型！JsonConvert反序列化时会把布尔值false转成字符串"False"，而你的GetSslMode方法只判断了"Required"/"VerifyCA"/"VerifyFull"，默认返回MySqlSslMode.None，虽然逻辑上没问题，但这种类型不匹配很容易在跨平台时引发奇怪的兼容性问题。

建议修改：

• 要么把cred.json里的SslMode改成字符串"None"，和代码逻辑对应；
• 要么把Cred类里的SslMode改成bool类型，调整GetSslMode方法：

  private MySqlSslMode GetSslMode(bool sslEnabled)
  {
      return sslEnabled ? MySqlSslMode.Required : MySqlSslMode.None;
      // 可根据实际需求调整逻辑
  }
  

2. 验证端口的类型转换 #

Cred类里Port是uint类型，而cred.json里是字符串"80"，虽然JsonConvert能自动转换，但可以加个调试输出确认：

Console.WriteLine($"解析后的端口：{json.Port}");
Console.WriteLine($"连接字符串：{conn.ToString()}");

看看连接字符串里的端口是不是确实是80，有没有被意外转换。

3. 捕获详细的MySQL错误信息 #

现在的错误提示connection must be valid and open太笼统，给Open()加异常捕获，输出精准的错误码和信息：

try
{
    MySqlConnection.Open();
}
catch (MySqlException ex)
{
    Console.WriteLine($"连接失败：{ex.Message}，错误码：{ex.Number}");
}

MySQL错误码能直接定位问题：

• 错误码2003：无法连接到服务器（服务没启动/端口没监听）；
• 错误码1045：权限验证失败；
• 错误码2026：SSL连接错误；

三、最后排查驱动和环境差异 #

• 确认Windows和Linux下使用的MySql.Data（或MySqlConnector）驱动版本一致，不同版本的跨平台处理逻辑可能有差异，建议升级到最新稳定版；
• 检查Linux下MySQL的字符集配置，确保utf8字符集被支持，避免因字符集不匹配导致连接失败。

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