ASP.NET API Docker部署：SQL Server连接仅直输密码可用

排查步骤与解决方案 #

1. 验证环境变量是否正确注入API容器 #

先确认DB_SA_PASSWORD环境变量是否真的传递到了API容器中：

• 进入API容器终端：

  docker exec -it <barcodeapi-container-id> bash
  

• 打印环境变量值：

  echo $DB_SA_PASSWORD
  

如果输出不是StrongPasswordExample，说明环境变量未正确设置，优先检查Compose文件格式。

2. 修正Docker Compose文件的缩进与主机配置 #

你的Compose文件中barcodeapi服务的environment字段下变量行缩进错误，会导致环境变量无法被识别；同时DB_HOST设为127.0.0.1在容器内指向自身，无法访问数据库容器。修正后的完整配置如下：

version: '3.4'

networks:
  barcodeapp:

services:
  barcodedb:
    container_name: barcode-db
    image: mcr.microsoft.com/mssql/server:2019-latest
    ports:
      - "8002:1433"
    environment:
      - ACCEPT_EULA=Y
      - SA_PASSWORD=StrongPasswordExample
    networks:
      barcodeapp:

  barcodeapi:
    image: ${DOCKER_REGISTRY-}barcodeapi
    build:
      context: .
      dockerfile: BarcodeAPI/Dockerfile
    ports:
      - "8001:80"
    depends_on:
      - barcodedb
    environment:
      - DB_HOST=barcodedb  # 同一Docker网络内用服务名直接访问数据库
      - DB_NAME=Barcode_API
      - DB_SA_PASSWORD=StrongPasswordExample
    networks:
      barcodeapp:

3. 在代码中添加日志验证变量值 #

在构建连接字符串前，添加日志输出确认读取到的密码值，排查是否为空或错误：

var dbHost = Environment.GetEnvironmentVariable("DB_HOST");
var dbName = Environment.GetEnvironmentVariable("DB_NAME");
var dbPassword = Environment.GetEnvironmentVariable("DB_SA_PASSWORD");

// 输出日志确认变量值
Console.WriteLine($"读取到的DB_SA_PASSWORD: {dbPassword ?? "空值"}");

var connectionString = $"Data Source={dbHost};Initial Catalog={dbName};User ID=sa;Password={dbPassword};MultipleActiveResultSets=True;TrustServerCertificate=True";
builder.Services.AddDbContext<BarcodeAPIDbContext>(opt => opt.UseSqlServer(connectionString));

查看API容器日志，如果输出为空，回到步骤1重新检查环境变量注入情况。

4. 确保数据库服务完全就绪 #

depends_on仅保证数据库容器先启动，但不保证SQL Server服务已初始化完成。可以为数据库服务添加健康检查，让API在数据库就绪后再启动：

barcodedb:
  container_name: barcode-db
  image: mcr.microsoft.com/mssql/server:2019-latest
  ports:
    - "8002:1433"
  environment:
    - ACCEPT_EULA=Y
    - SA_PASSWORD=StrongPasswordExample
  networks:
    barcodeapp:
  healthcheck:
    test: ["CMD-SHELL", "/opt/mssql-tools/bin/sqlcmd -S localhost -U sa -P StrongPasswordExample -Q 'SELECT 1' || exit 1"]
    interval: 10s
    timeout: 5s
    retries: 5

barcodeapi:
  # ...其他配置
  depends_on:
    barcodedb:
      condition: service_healthy

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