Docker部署MySQL与ASP.NET Core：数据库连接与API访问冲突问题

核心问题分析 #

• 使用--network=host时，容器直接复用主机网络，能通过localhost访问MySQL，但Docker端口映射会失效（host网络下-p参数不生效），导致外部无法访问API。
• 不使用--network=host时，容器默认在bridge网络，和MySQL容器不在同一可解析名称的网络中，若连接字符串用localhost会指向容器自身而非主机的MySQL，因此连接失败。

解决方案步骤 #

1. 创建自定义Docker网络

自定义网络支持容器间的名称解析，是容器间通信的标准方案：

docker network create app-network

2. 重新启动MySQL容器并加入自定义网络

先清理原有MySQL容器（若存在）：

docker stop mysql && docker rm mysql

再用自定义网络启动MySQL：

docker run -d --name mysql --network=app-network -e MYSQL_ROOT_PASSWORD=root -e MYSQL_DATABASE=db -p 3306:3306 mysql:latest

保留-p 3306:3306是为了主机也能直接访问MySQL，不影响容器间通信。

3. 修改ASP.NET Core的数据库连接字符串

将连接字符串中的主机名从localhost改为MySQL容器的名称mysql，示例：

// appsettings.json 配置示例
{
  "ConnectionStrings": {
    "DefaultConnection": "server=mysql;database=db;user=root;password=root;"
  }
}

同一自定义网络内，Docker DNS会自动将mysql解析为对应容器的IP地址。

4. 重新构建并启动ASP.NET Core容器

重新构建镜像（代码未修改可跳过）：

docker build --rm -t dev/app:latest .

启动容器时加入自定义网络，保留端口映射，不要使用--network=host：

docker run --rm -p 5000:5000 -p 5001:5001 -e ASPNETCORE_HTTPS_PORT=5001 -e ASPNETCORE_URLS="http://+:5000;https://+:5001" --network=app-network dev/app:latest

注意：你之前的环境变量ASPNETCORE=HTTP_PORT=https://+:5001存在错误，正确的HTTPS端口配置为ASPNETCORE_HTTPS_PORT=5001，同时ASPNETCORE_URLS需包含HTTP和HTTPS的监听地址。

验证效果 #

• 浏览器访问http://localhost:5000或https://localhost:5001，可正常打开API和Swagger页面。
• ASP.NET Core服务能正常连接MySQL容器，执行数据库相关操作。

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