Ubuntu下ASP.NET Core环境变量异常导致Swagger无法启用

1. 修正代码判断逻辑 #

放弃直接读取环境变量的写法，改用框架提供的IWebHostEnvironment工具方法，避免手动拼写错误，同时更贴合ASP.NET Core的环境管理规范：

using Microsoft.AspNetCore.Hosting;

// .NET 6+ Program.cs示例
var builder = WebApplication.CreateBuilder(args);
// ... 其他服务配置

var app = builder.Build();

// 使用框架内置的环境判断方法
if (app.Environment.IsDevelopment() || app.Environment.IsStaging())
{
    app.UseSwagger();
    app.UseSwaggerUI();
}

// ... 其他中间件配置
app.Run();

2. 确保Ubuntu服务器上环境变量持久生效 #

场景一：直接终端运行应用 #

export命令仅对当前终端会话有效，关闭终端后失效。要持久化配置，编辑用户配置文件：

1. 打开~/.bashrc或~/.profile文件
2. 添加一行：export ASPNETCORE_ENVIRONMENT=Development
3. 执行source ~/.bashrc使配置立即生效，再重启应用

场景二：systemd托管应用（生产部署常用） #

如果用systemd管理应用服务，需将环境变量写入服务配置文件：

1. 打开服务文件（通常路径：/etc/systemd/system/你的应用名称.service）
2. 在[Service]区块下添加：

   Environment="ASPNETCORE_ENVIRONMENT=Development"
   

3. 重新加载systemd配置并重启服务：

   sudo systemctl daemon-reload
   sudo systemctl restart 你的应用名称.service
   

3. Azure DevOps流水线的正确配置 #

方式一：SSH部署时直接配置服务器环境 #

在流水线的SSH任务中，直接修改systemd服务文件或持久化环境变量：

- task: SSH@0
  inputs:
    sshEndpoint: '你的Ubuntu服务器连接'
    runOptions: 'commands'
    commands: |
      # 向systemd服务文件添加环境变量
      sudo sed -i '/\[Service\]/a Environment="ASPNETCORE_ENVIRONMENT=Development"' /etc/systemd/system/你的应用名称.service
      sudo systemctl daemon-reload
      sudo systemctl restart 你的应用名称.service

方式二：发布任务中传递运行时环境变量 #

若部署到Azure App Service Linux，可在流水线的发布任务中，找到「应用设置」或「环境变量」选项，添加键值对：ASPNETCORE_ENVIRONMENT=Development

4. 验证环境变量是否生效 #

部署后通过以下方式确认配置：

• 查看应用日志，搜索ASPNETCORE_ENVIRONMENT，确认值是否符合预期
• 用systemd托管时，执行systemctl show 你的应用名称.service | grep Environment查看服务加载的环境变量
• 临时添加接口输出当前环境：

  app.MapGet("/check-env", (IWebHostEnvironment env) => env.EnvironmentName);
  

  访问该接口，返回的名称应与设置一致

常见误区提醒 #

• 不要混淆buildConfiguration和ASPNETCORE_ENVIRONMENT：前者是编译时配置（Debug/Release），后者是运行时环境，两者无直接关联，设置buildConfiguration: 'Staging'不会自动改变运行时环境
• 避免硬编码环境名称，始终使用IsDevelopment()、IsStaging()等框架方法，降低拼写错误概率

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