.NET Core 3.1 WebAPI执行scaffold连接RDS MySQL提示无法连接指定主机

报错本质是MySQL连接驱动在TCP链路阶段就无法访问指定的RDS实例，和Scaffold逆向工程逻辑无关，可按以下优先级排查遗漏配置：

1. RDS实例基础配置 #

• 确认RDS实例已开启公网访问能力，你使用的连接地址是公网地址而非VPC内网地址
• 确认RDS实例状态为运行中，没有处于重启、升级、冻结等异常状态
• 确认连接端口和RDS配置一致，默认3306，若有自定义修改需同步修改连接字符串

2. 网络访问规则配置 #

• RDS安全组入方向规则：除开放3306端口外，需确认源IP段包含你当前开发环境的公网出口IP，仅配置0.0.0.0/0可能因云厂商安全策略不生效，可临时将你本地公网IP单独加入白名单测试
• 本地网络出向规则：确认你当前的办公网络、家庭网络没有封禁3306端口的出站请求，可执行命令telnet <RDS公网地址> 3306验证端口连通性
• 代理/VPN影响：若当前开启了代理、VPN工具，需确认RDS地址的流量没有被路由到异常节点，可关闭相关工具后重试

3. MySQL账号权限配置 #

• 确认你使用的数据库账号允许从你本地公网IP登录，默认RDS账号可能仅允许内网IP访问，可使用高权限账号执行SQL修改权限：

UPDATE mysql.user SET host = '%' WHERE user = '你的数据库账号名';
FLUSH PRIVILEGES;

• 确认账号密码输入正确，连接字符串中包含特殊字符时需做转义处理

4. 项目依赖与Scaffold命令配置 #

• 确认Pomelo.EntityFrameworkCore.MySql版本与.NET Core 3.1兼容，推荐使用3.2.x版本，不要使用5.0及以上版本避免不兼容
• 确认Scaffold命令中的连接字符串格式正确，示例参考：

# Package Manager Console 命令示例
Scaffold-DbContext "server=RDS公网地址;port=3306;user=账号;password=密码;database=数据库名;SslMode=None;" Pomelo.EntityFrameworkCore.MySql -OutputDir Models -Force

• 特别注意SslMode参数：如果RDS未开启强制SSL连接，需设置SslMode=None，若开启了SSL则需要配置SslMode=Required并导入对应RDS厂商的CA证书

5. 基础连通性验证 #

可先在项目中编写简单连接测试代码，排除Scaffold工具本身的问题：

using MySqlConnector;

var connStr = "你的数据库连接字符串";
using var conn = new MySqlConnection(connStr);
try
{
    conn.Open();
    Console.WriteLine("连接成功");
}
catch (Exception ex)
{
    Console.WriteLine($"连接失败，错误信息：{ex.Message}");
}

如果该测试也无法连接，说明问题出在网络、账号层面，和Scaffold命令无关。

内容的提问来源于stack exchange，提问作者Robinson Ascencio Peña