Docker中运行Visual Studio 2019 .NET Web应用无法连接外部MySQL服务器

问题描述 #

使用Visual Studio 2019开发的.NET Web应用，在IIS托管环境下可正常连接Synology NAS上的MySQL服务器，但构建Docker镜像部署到Synology服务器后，访问涉及数据库连接的页面时出现以下错误：

Server Error in '/' Application.
Unable to find the requested .Net Framework Data Provider. It may not be installed.

异常详细信息: System.ArgumentException: Unable to find the requested .Net Framework Data Provider. It may not be installed.

堆栈跟踪:
[ArgumentException: Unable to find the requested .Net Framework Data Provider. It may not be installed.]
System.Data.Common.DbProviderFactories.GetFactory(String providerInvariantName) +1326077
System.Web.UI.WebControls.SqlDataSource.GetDbProviderFactorySecure() +35
...（省略后续堆栈信息）
版本信息: Microsoft .NET Framework Version:4.0.30319; ASP.NET Version:4.8.4494.0

已尝试安装MySQL连接器但问题未解决，应用可正常启动，仅数据库相关页面报错。

解决步骤 #

1. 在Docker镜像中安装MySQL Connector/NET #

Docker默认的.NET Framework基础镜像（如mcr.microsoft.com/dotnet/framework/aspnet:4.8）不包含MySQL数据提供器，需在Dockerfile中添加安装步骤：

# 在部署应用前添加以下命令，安装对应版本的MySQL Connector/NET
RUN powershell -Command \
    Set-ExecutionPolicy Bypass -Scope Process -Force; \
    [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; \
    iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1')); \
    choco install mysql-connector-net -y --version=8.0.33

注意替换--version后的版本号，确保与本地项目使用的MySQL Connector/NET版本一致。

2. 确认Web.config中的数据提供器配置 #

检查Web.config的<DbProviderFactories>节点，确保MySQL工厂配置正确：

<system.data>
  <DbProviderFactories>
    <remove invariant="MySql.Data.MySqlClient" />
    <add name="MySQL Data Provider" 
         invariant="MySql.Data.MySqlClient" 
         description=".Net Framework Data Provider for MySQL" 
         type="MySql.Data.MySqlClient.MySqlClientFactory, MySql.Data, Version=8.0.33.0, Culture=neutral, PublicKeyToken=c5687fc88969c44d" />
  </DbProviderFactories>
</system.data>

版本号和PublicKeyToken需与安装的连接器版本匹配，若项目通过NuGet引用MySql.Data，该配置通常会自动生成，但需确保镜像中版本一致。

3. 确保NuGet依赖文件复制到镜像 #

若项目通过NuGet引用MySql.Data，需确认Dockerfile的COPY步骤将项目输出（包括bin目录下的MySql.Data.dll等文件）复制到IIS站点目录：

COPY --from=build ["<项目输出路径>", "C:\\inetpub\\wwwroot"]

替换<项目输出路径>为实际的本地编译输出目录。

4. 验证容器内连接器安装状态 #

进入Docker容器检查连接器是否安装成功：

# 替换<容器ID>为你的容器ID
docker exec -it <容器ID> powershell
# 查询已安装的MySQL连接器
Get-WmiObject -Class Win32_Product | Where-Object {$_.Name -like "*MySQL Connector*"}

若未查到安装记录，需排查Dockerfile中安装命令的问题，比如网络是否能访问Chocolatey源，或改用离线安装包。

5. 检查连接字符串的提供器名称 #

确认Web.config中连接字符串的providerName配置正确：

<connectionStrings>
  <add name="MySqlConn" 
       connectionString="server=你的Synology NAS IP;database=数据库名;uid=用户名;pwd=密码;" 
       providerName="MySql.Data.MySqlClient" />
</connectionStrings>

确保providerName与<DbProviderFactories>中的invariant值一致。

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