.NET6升级.NET9后，部署的ASP.NET Core应用无法监听5001端口

问题根源 #

VS启动项目时会优先读取launchsettings.json的配置，你在全局appsettings.json中硬编码Kestrel端点后，和VS的启动端口配置产生冲突，导致启动失败。.NET 9在端口默认监听逻辑上比.NET 6更严格，所以出现了之前未遇到的问题。

解决方案：环境分离配置 #

通过环境特定配置文件区分开发与部署环境的端口设置，无需修改Program.cs：

1. 创建生产环境配置文件 #

在项目根目录新建appsettings.Production.json，写入部署所需的Kestrel配置：

"Kestrel": {
    "Endpoints": {
        "Http": {
            "Url": "http://127.0.0.1:5000"
        },
        "Https": {
            "Url": "https://localhost:5001"
        }
    }
}

2. 移除全局配置中的Kestrel设置 #

删除appsettings.json里的Kestrel端点配置，让开发环境默认使用VS的launchsettings.json配置。

3. 确认开发环境启动配置 #

检查Properties/launchsettings.json中的applicationUrl，确保开发端口符合需求（默认通常为https://localhost:5001;http://localhost:5000），示例片段：

"profiles": {
    "http": {
        "commandName": "Project",
        "dotnetRunMessages": true,
        "launchBrowser": true,
        "applicationUrl": "http://localhost:5000",
        "environmentVariables": {
            "ASPNETCORE_ENVIRONMENT": "Development"
        }
    },
    "https": {
        "commandName": "Project",
        "dotnetRunMessages": true,
        "launchBrowser": true,
        "applicationUrl": "https://localhost:5001;http://localhost:5000",
        "environmentVariables": {
            "ASPNETCORE_ENVIRONMENT": "Development"
        }
    }
}

4. 部署时指定生产环境 #

部署到本地文件夹后，启动应用时通过环境变量指定生产环境，让应用读取appsettings.Production.json的配置：

• 命令行启动示例：

set ASPNETCORE_ENVIRONMENT=Production
dotnet YourProject.dll

• 也可在部署脚本中设置环境变量，确保应用加载生产配置。

这样设置后，VS启动项目时使用开发环境配置（依赖launchsettings），部署运行时使用生产环境的Kestrel端口配置，两者互不冲突。

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