.NET Core 3.1 服务在 Docker Compose 中无法覆盖自定义端口配置问题

1. 环境变量配置不生效问题 #

.NET Core 配置系统遵循后添加的配置源优先级更高的规则，环境变量不生效的核心原因是默认配置源顺序被修改，或者未显式添加环境变量配置源：

• 确认CreateHostBuilder方法中使用Host.CreateDefaultBuilder(args)初始化，默认逻辑已经按「appsettings.json → appsettings.{环境}.json → 环境变量 → 命令行参数」的优先级加载配置，环境变量优先级高于JSON配置。
• 如果手动自定义了配置源，需保证AddEnvironmentVariables()在AddJsonFile()之后添加，确保环境变量可以覆盖JSON配置，示例代码：

public static IHostBuilder CreateHostBuilder(string[] args) =>
    Host.CreateDefaultBuilder(args)
        .ConfigureAppConfiguration((context, config) =>
        {
            // 自定义配置源需按优先级从低到高添加
            config.AddJsonFile("appsettings.json", optional: false, reloadOnChange: true)
                  // 环境变量配置源放在JSON之后，优先级更高
                  .AddEnvironmentVariables();
        })
        .ConfigureServices(services =>
        {
            services.AddHostedService<Worker>();
        });

• 现有代码中读取端口的判空逻辑存在缺陷，若配置不存在会返回null，不等于空字符串会直接触发转换异常，建议修改为：

var portStr = _configuration["Service:Port"];
var port = string.IsNullOrEmpty(portStr) ? 9876 : Convert.ToInt32(portStr);

• Dockerfile中定义的ENV SERVICE__PORT=1234可以删除，docker-compose中定义的环境变量会自动覆盖镜像内的ENV值。

2. VS2019启动时卷挂载不生效问题 #

该问题由VS Docker工具的两个默认特性导致，按以下步骤修复：

1. 关闭快速调试模式：右键docker-compose项目 → 选择「属性」→ 常规选项卡 → 取消勾选「使用快速模式调试」。快速模式为了加速启动会跳过部分镜像构建逻辑，且会覆盖部分自定义卷配置。
2. 修正挂载路径的相对位置：VS启动docker-compose时的工作目录为解决方案根目录，和手动执行docker命令的工作目录可能不一致，建议使用VS预定义变量${MSBuildProjectDirectory}（代表docker-compose项目所在目录）来拼接绝对路径，修改compose的volumes配置：

volumes: 
  - ${MSBuildProjectDirectory}/Settings/appsettings.docker.json:c:/app/appsettings.json
  - ${MSBuildProjectDirectory}/Logs:c:/app/logs

3. 多实例部署配置示例 #

要部署1111、2222两个端口的实例，直接在compose中定义两个服务，分别设置不同的环境变量即可，无需重复构建镜像：

version: '3.4'

services:
  service-1111:
    environment:
      SERVICE__PORT: 1111
    image: ${DOCKER_REGISTRY-}service1
    build:
      context: .
      dockerfile: service1/Dockerfile
    volumes: 
      - ${MSBuildProjectDirectory}/Settings/appsettings.docker.json:c:/app/appsettings.json
      - ${MSBuildProjectDirectory}/Logs/service1111:c:/app/logs
  service-2222:
    environment:
      SERVICE__PORT: 2222
    image: ${DOCKER_REGISTRY-}service1
    volumes: 
      - ${MSBuildProjectDirectory}/Settings/appsettings.docker.json:c:/app/appsettings.json
      - ${MSBuildProjectDirectory}/Logs/service2222:c:/app/logs

配置完成后无论是手动执行docker-compose命令还是通过VS启动，都可以正常读取对应端口配置。

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