空白ASP.NET Core 2.0应用部署Azure报502.5错误：绑定失败，EACCESS权限拒绝

从你提供的Kudo错误日志来看，核心问题是你的应用尝试硬绑定到localhost:5000端口，但在Azure App Service的沙箱环境中，这个操作会因为权限限制失败——Azure会为每个应用动态分配端口，并通过PORT环境变量告知应用应该监听哪个端口，而不是允许应用固定使用5000端口。

下面是具体的排查和修复步骤：

1. 修正Program.cs中的端口绑定配置 #

ASP.NET Core 2.0应用应该监听环境变量指定的端口，而不是硬编码localhost:5000。检查你的Program.cs，确保WebHost配置没有强制绑定固定端口：

错误示例（硬编码端口）： #

public static IWebHost BuildWebHost(string[] args) =>
    WebHost.CreateDefaultBuilder(args)
        .UseStartup<Startup>()
        .UseUrls("http://localhost:5000") // 这里硬编码了端口，导致Azure环境下失败
        .Build();

正确配置（使用环境变量）： #

修改为让Kestrel自动读取Azure提供的PORT环境变量，或者显式处理：

using System;
using System.Net;
using Microsoft.AspNetCore;
using Microsoft.AspNetCore.Hosting;

namespace doesthiswork
{
    public class Program
    {
        public static void Main(string[] args)
        {
            BuildWebHost(args).Run();
        }

        public static IWebHost BuildWebHost(string[] args) =>
            WebHost.CreateDefaultBuilder(args)
                .UseStartup<Startup>()
                .UseKestrel(options =>
                {
                    // 读取Azure分配的PORT变量，本地开发默认用5000
                    var port = Environment.GetEnvironmentVariable("PORT") ?? "5000";
                    options.Listen(IPAddress.Any, int.Parse(port));
                })
                .Build();
        }
    }
}

或者更简洁的方式，CreateDefaultBuilder已经会自动处理环境变量，你可以直接移除UseUrls的硬编码，让框架自动适配：

public static IWebHost BuildWebHost(string[] args) =>
    WebHost.CreateDefaultBuilder(args)
        .UseStartup<Startup>()
        .Build();

2. 验证Web.config配置 #

确保部署的包中包含正确的web.config，AspNetCoreModule会负责将请求转发到应用的端口，不需要在配置中指定端口：

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <system.webServer>
    <handlers>
      <add name="aspNetCore" path="*" verb="*" modules="AspNetCoreModule" resourceType="Unspecified" />
    </handlers>
    <aspNetCore processPath="dotnet" arguments=".\doesthiswork.dll" stdoutLogEnabled="true" stdoutLogFile=".\logs\stdout" />
  </system.webServer>
</configuration>

3. 确认Azure应用设置 #

登录Azure门户，进入你的应用服务，检查配置 > 应用程序设置，确保没有手动设置错误的端口相关变量（比如ASPNETCORE_URLS），如果有，建议移除，让Azure自动管理端口分配。

4. 重新部署并测试 #

修改代码后，重新推送变更到仓库触发持续部署，部署完成后再次访问网站。如果问题仍然存在，可以在Kudo中运行以下命令查看当前环境变量，确认PORT是否存在：

echo %PORT%

如果PORT变量存在，说明Azure已经正确分配了端口，此时应用应该能正常监听该端口并处理请求。

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