.NET发布版React应用端口与开发环境不一致的配置咨询

问题背景 #

调试React + .NET项目时，会启动两个终端分别运行React前端开发服务器和.NET后端，日志显示监听https://localhost:7291、http://localhost:5026，环境为Development。发布到VPS后，运行exe时仅监听http://localhost:5000，环境为Production，且无需再启动React终端（前端已打包为wwwroot静态资源）。需要让发布后的应用配置（监听地址、环境标识等）与开发环境一致，已尝试修改launchsettings.json但无效（该文件仅对本地开发生效）。

解决方案 #

1. 通过环境变量指定配置（核心方式） #

launchsettings.json仅在本地开发（如VS启动项目）时生效，发布后的应用需通过环境变量或命令行参数配置：

临时生效（单次运行）

在VPS的命令行中执行以下命令后再运行exe：

# 设置环境为Development
set ASPNETCORE_ENVIRONMENT=Development
# 指定监听地址（与开发环境一致）
set ASPNETCORE_URLS=https://localhost:7291;http://localhost:5026
# 运行应用程序
.\ReactNet.exe

永久生效（Windows VPS）

1. 打开「系统属性」→「高级」→「环境变量」
2. 在「系统变量」中添加：
   • 变量名：ASPNETCORE_ENVIRONMENT，变量值：Development
   • 变量名：ASPNETCORE_URLS，变量值：https://localhost:7291;http://localhost:5026
3. 重启命令行终端，直接运行exe即可生效。

2. 确保HTTPS证书可用 #

开发环境使用的是本地HTTPS开发证书，发布到VPS后需确保证书可被应用识别：

• 导入本地开发证书：从本地导出.pfx格式的开发证书（自行设置密码），上传到VPS后，导入到「本地计算机」→「个人」证书存储。
• 生成新的自签名证书（测试用）：在VPS的命令行中执行：

  dotnet dev-certs https --trust
  

  该命令会生成并信任自签名证书，仅适用于测试场景，生产环境建议使用CA签发的正式证书。

3. 确保开发环境配置文件被包含 #

如果项目依赖appsettings.Development.json中的配置，需确保发布时该文件被复制到输出目录：

1. 打开项目的.csproj文件
2. 添加以下内容：

   <ItemGroup>
     <Content Include="appsettings.Development.json">
       <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
     </Content>
   </ItemGroup>
   

3. 重新发布项目，appsettings.Development.json会被包含在发布文件夹中。

验证配置 #

运行exe后，查看日志应与开发环境一致：

info: Microsoft.Hosting.Lifetime[14]
      Now listening on: https://localhost:7291
info: Microsoft.Hosting.Lifetime[14]
      Now listening on: http://localhost:5026
info: Microsoft.Hosting.Lifetime[0]
      Application started. Press Ctrl+C to shut down.
info: Microsoft.Hosting.Lifetime[0]
      Hosting environment: Development

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