.NET 7 API容器中Environment.IsDevelopment()始终返回false的问题

问题背景 #

将.NET 7 API容器化后，Docker中运行时appBuilder.Environment.IsDevelopment()始终返回false，导致CORS配置不生效。本地Visual Studio调试正常，launch.settings中已正确设置ASPNETCORE_ENVIRONMENT=Development。

Docker Compose初始配置如下：

version: '3.3'
services:
    xxxapi:
        environment:
        - DOTNET_ENVIRONMENT="Development"
        - ASPNETCORE_ENVIRONMENT="Development"
        ports:
            - '28227:80'
            - '44392:443'
        container_name: xxx.Api
        image: xxx.azurecr.io/core/xxxapi:latest

进入容器终端执行env命令确认变量存在，但打印EnvironmentName后发现值为"Development"（带引号），正是引号导致环境判断失败。

解决步骤 #

1. 修正Docker Compose的环境变量写法 #

Docker Compose中使用- KEY="VALUE"格式时，引号会被当作变量值的一部分传递给容器，因此需要去掉引号：

version: '3.3'
services:
    xxxapi:
        environment:
        - DOTNET_ENVIRONMENT=Development
        - ASPNETCORE_ENVIRONMENT=Development
        ports:
            - '28227:80'
            - '44392:443'
        container_name: xxx.Api
        image: xxx.azurecr.io/core/xxxapi:latest

也可以使用更清晰的键值对写法（彻底避免引号问题）：

version: '3.3'
services:
    xxxapi:
        environment:
          DOTNET_ENVIRONMENT: Development
          ASPNETCORE_ENVIRONMENT: Development
        ports:
            - '28227:80'
            - '44392:443'
        container_name: xxx.Api
        image: xxx.azurecr.io/core/xxxapi:latest

2. 验证环境变量正确性 #

重新启动容器后，进入终端执行env命令，确认ASPNETCORE_ENVIRONMENT和DOTNET_ENVIRONMENT的值为Development（无引号）。此时IsDevelopment()会正确返回true，CORS配置也会生效。

3. Dockerfile中的注意事项 #

如果之前在Dockerfile中设置过环境变量，同样要确保写法不带引号：

# 正确写法
ENV ASPNETCORE_ENVIRONMENT Development
ENV DOTNET_ENVIRONMENT Development

# 错误写法（会带引号）
ENV ASPNETCORE_ENVIRONMENT "Development"

原理说明 #

.NET中IsDevelopment()方法是精确匹配字符串的，带引号的"Development"和预期的Development不属于同一个字符串，因此判断失败。只要确保环境变量值不带引号，就能让应用正确识别开发环境。

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