如何使用统一连接字符串从本地及容器连接Docker中的SQL Server

当容器中运行SQL Server时，本地主机运行的API连接它需要一种连接字符串，而通过Docker Compose同时运行SQL Server和API时则需要另一种。

我的Docker Compose配置 #

version: '3.9'

volumes:
  SqlDataStorage:
  
networks:
  my-network:
    driver: bridge

services:
  weather.api:
    container_name: WeatherForecastApi
    image: maks0s/weather-app:6.1.0
    build:
      context: .
    environment:
      - ASPNETCORE_ENVIRONMENT=Development
      - ASPNETCORE_HTTP_PORTS=8080
      - ASPNETCORE_HTTPS_PORTS=8081
      - ASPNETCORE_Kestrel__Certificates__Default__Password=********
      - ASPNETCORE_Kestrel__Certificates__Default__Path=/https/aspnetapp.pfx
    ports:
      - '5000:8080'
      - '5001:8081'
    volumes:
      - ~/.aspnet/https:/https:ro
    networks:
      - my-network
    depends_on:
      - weather.db

  weather.db:
    container_name: WeatherForecastCloudDb
    image: mcr.microsoft.com/mssql/server:2022-latest
    env_file:
      - sqlconfig.env
      - sapassword.env
    ports:
      - '1439:1433'
    volumes:
      - SqlDataStorage:/var/opt/mssql
    networks:
      - my-network

两种连接字符串 #

• 本地主机API连接容器SQL Server：

  "Data Source=host.docker.internal,1439;Initial Catalog=WeatheForecastDb;User ID=sa;Password=**********; Trust Server Certificate=True; MultiSubnetFailover=True"
  

• Docker Compose同时运行API和SQL Server：

  "Data Source=weather.db;Initial Catalog=WeatheForecastDb;User ID=sa;Password=**********; Trust Server Certificate=True; MultiSubnetFailover=True"
  

提问：是否可以创建统一的连接字符串，还是必须通过环境变量判断，在启动时动态生成连接字符串？

解决方案 #

无法直接使用完全硬编码的统一连接字符串，因为两种场景下数据库的访问地址逻辑本质不同：

• 本地API访问容器数据库：依赖宿主机的端口映射和host.docker.internal域名
• Docker Compose内部访问：利用容器网络的内置DNS解析，直接使用服务名weather.db

但可以通过环境变量注入实现统一的配置管理，不需要在代码中做分支判断，具体有两种可行方式：

方式1：注入完整连接字符串 #

在Docker Compose的weather.api服务中直接注入适配容器网络的连接字符串：

services:
  weather.api:
    environment:
      # 保留原有环境变量
      - ConnectionStrings__WeatherDb="Data Source=weather.db;Initial Catalog=WeatheForecastDb;User ID=sa;Password=**********; Trust Server Certificate=True; MultiSubnetFailover=True"

本地运行API时，直接在appsettings.Development.json或系统环境变量中设置适配本地场景的连接字符串即可。

方式2：拆分参数动态拼接 #

把连接字符串的可变部分（数据源）抽为环境变量，统一配置模板：

1. 在API的appsettings.json中定义连接字符串模板：

   {
     "ConnectionStrings": {
       "WeatherDb": "Data Source=${DB_HOST};Initial Catalog=WeatheForecastDb;User ID=${DB_USER};Password=${DB_PASSWORD}; Trust Server Certificate=True; MultiSubnetFailover=True"
     }
   }
   

2. Docker Compose中注入容器环境的参数：

   services:
     weather.api:
       environment:
         - DB_HOST=weather.db
         - DB_USER=sa
         - DB_PASSWORD=**********
     # weather.db配置保持不变
   

3. 本地运行时，通过终端或系统环境变量注入本地参数：

   # Windows（PowerShell）
   $env:DB_HOST="host.docker.internal,1439"
   $env:DB_USER="sa"
   $env:DB_PASSWORD="**********"
   
   # Linux/macOS
   export DB_HOST="host.docker.internal,1439"
   export DB_USER="sa"
   export DB_PASSWORD="**********"
   

这种方式的核心是保持连接字符串模板统一，仅根据运行环境注入不同的DB_HOST参数，代码无需做任何逻辑判断。

总结：不需要在代码中动态生成连接字符串，通过环境变量注入即可实现跨场景的配置统一管理。

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