ASP.NET Core API+Docker环境下Entity Framework迁移连接问题求助

问题根源 #

• 本地主机执行EF迁移时，命令运行在宿主机上，Docker容器名postgres_image属于Docker内部网络域名，宿主机无法直接解析，因此必须用localhost（Postgres容器已将5432端口映射到宿主机）。
• API运行在Docker容器内时，处于自定义网络grdeapi-dev中，可直接通过容器名postgres_image访问数据库，但用localhost会指向容器自身，导致连接失败。

解决方案 #

方案1：用环境变量动态切换连接字符串 #

通过环境变量让连接字符串根据运行环境自动切换主机：

1. 修改appsettings.json中的连接字符串：

"ConnectionStrings": {
  "DefaultConnection": "Host=${DB_HOST:-postgres_image};Port=5432;Database=grdedb;Username=postgres;Password=postgres"
}

2. 本地执行迁移前，在终端设置环境变量：

# Linux/macOS
export DB_HOST=localhost

# Windows cmd
set DB_HOST=localhost

# Windows PowerShell
$env:DB_HOST=localhost

3. 执行EF迁移命令：

dotnet ef migrations add InitialCreate
dotnet ef database update

4. 启动Docker容器时无需额外配置，容器会默认使用postgres_image作为主机名。

方案2：在Docker容器内执行EF迁移 #

直接在API容器内部运行迁移命令，利用Docker内部网络解析容器名：

1. 启动所有容器：

docker-compose up -d

2. 进入API容器终端：

docker-compose exec grdeapi bash

3. 在容器内执行迁移：

dotnet ef migrations add InitialCreate
dotnet ef database update

4. 退出容器即可，API连接字符串保持postgres_image不变。

报错补充说明 #

你遇到的Failed to connect to 212.95.74.75:5432错误，是因为本地主机解析postgres_image时出现DNS异常，意外指向了公网IP，这也验证了宿主机无法正确识别Docker容器名的问题。

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