.NET Core Web API 7.0发布后MySQL数据库连接失败问题求助

问题场景 #

搭建ASP.NET Core Web API时，本地Visual Studio中构建运行正常（监听localhost:7272，可正常处理请求），但发布项目并运行输出文件夹中的可执行文件时，API监听localhost:5000，且出现报错：

An error occurred using the connection to database '' on server ''

已尝试的操作：

• 添加EnableRetryOnFailure配置
• 更换多次连接字符串模板
• 引入Pomelo.EntityFrameworkCore.MySql包

相关代码与配置 #

Program.cs 数据库配置代码：

var serverVersion = new MySqlServerVersion(new Version(8, 0, 29));
builder.Services.AddDbContext<GameDbContext>(
    dbContextOptions => dbContextOptions
        .UseMySql(builder.Configuration.GetConnectionString("Db"), serverVersion, mySqlOptions =>
            mySqlOptions.EnableRetryOnFailure(
                maxRetryCount: 10,
                maxRetryDelay: TimeSpan.FromSeconds(30),
                errorNumbersToAdd: null))
        );

连接字符串模板（appsettings.json）：

"ConnectionStrings": {
  "Db": "Server=serverIP,port;Database=dbName;User Id=userId;Password=password;"
}

修复方案 #

1. 检查发布后的配置文件完整性 #

• 确认项目中appsettings.json的「生成操作」设置为内容，「复制到输出目录」设置为始终复制或较新时复制（右键文件→属性查看），确保发布时配置文件被正确复制到输出目录。
• 运行可执行文件前，检查同目录下是否存在appsettings.json，且文件中的ConnectionStrings配置已替换为实际的服务器IP、端口、数据库名、账号密码，无占位符残留。
• 如果使用了环境特定配置文件（如appsettings.Production.json），需确认该文件同样被包含在发布输出中，且配置正确。

2. 验证配置读取的正确性 #

在Program.cs中添加临时日志输出，确认读取到的连接字符串是否完整：

var connectionString = builder.Configuration.GetConnectionString("Db");
Console.WriteLine($"读取到的连接字符串：{connectionString}");

发布后运行可执行文件，查看控制台输出的连接字符串是否包含服务器地址、数据库名等关键信息，排查是否存在配置读取失败的情况。

3. 排查环境变量干扰 #

ASP.NET Core会优先读取环境变量中的配置项，如果发布机器上存在ConnectionStrings__Db环境变量，可能会覆盖配置文件中的值。可暂时移除该环境变量后重新测试，确认是否是环境变量导致的配置异常。

4. 验证数据库网络连通性 #

• 在运行可执行文件的机器上，尝试ping MySQL服务器IP，确认网络可达。
• 检查MySQL服务器的防火墙规则，确保开放了对应的端口，允许发布机器访问。
• 使用MySQL客户端工具（如MySQL Workbench）在发布机器上直接测试数据库连接，验证账号密码、服务器地址、端口、数据库名的正确性，排除数据库端的配置问题。

5. 检查环境模式配置差异 #

本地运行默认使用Development环境，发布默认使用Production环境。检查Program.cs或相关配置代码中，是否针对不同环境设置了差异化的数据库连接逻辑，避免Production环境下未正确读取配置。

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