.NET Core API如何检查服务器Web主机环境并修改？

一、检查当前API运行的环境 #

可以通过以下几种方式确认当前环境：

1. 新增接口返回环境名称 #

在Program.cs中添加一个简单接口，直接返回当前环境名称：

app.MapGet("/current-env", (IWebHostEnvironment env) => new { EnvironmentName = env.EnvironmentName });

启动API后，访问http://<你的API地址>/current-env，就能看到当前运行的环境名称。

2. 查看环境变量 #

• Windows命令行：执行以下命令查看临时环境变量

  echo %ASPNETCORE_ENVIRONMENT%
  

• Linux/macOS终端：执行以下命令

  echo $ASPNETCORE_ENVIRONMENT
  

• Visual Studio调试配置：右键项目 → 属性 → 调试 → 查看"环境变量"区域的ASPNETCORE_ENVIRONMENT值。

3. 检查launchSettings.json文件 #

打开项目根目录下Properties文件夹中的launchSettings.json，查看对应启动配置里的环境变量：

"profiles": {
  "YourApiName": {
    "commandName": "Project",
    "environmentVariables": {
      "ASPNETCORE_ENVIRONMENT": "Development"
    }
  }
}

二、修改API运行环境 #

根据需求将环境改为Development、Isolated或Local，方法如下：

1. 通过环境变量临时设置 #

• Windows：命令行执行

  set ASPNETCORE_ENVIRONMENT=Development
  

• Linux/macOS：终端执行

  export ASPNETCORE_ENVIRONMENT=Development
  

注意：这种方式仅对当前终端会话有效，重启终端后失效。

2. 通过IDE永久修改调试环境 #

在Visual Studio中，右键项目 → 属性 → 调试 → 在"环境变量"区域添加或修改ASPNETCORE_ENVIRONMENT的值为目标环境（如Isolated或Local）。

3. 修改launchSettings.json文件 #

直接编辑Properties/launchSettings.json，将对应启动配置的ASPNETCORE_ENVIRONMENT值修改为目标环境：

"environmentVariables": {
  "ASPNETCORE_ENVIRONMENT": "Local"
}

修改后启动项目，API会自动使用该环境配置。

额外排查：Swagger路径问题 #

若环境设置正确后仍出现404，可直接访问Swagger JSON路径验证：http://<你的API地址>/swagger/v1/swagger.json。如果该路径也返回404，需检查Swagger的配置是否正确，比如确认AddSwaggerGen已在服务配置中正确添加，且版本号与SwaggerEndpoint中的v1一致。

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