Azure App Service私有端点返回404错误，请求排查协助

核心原因分析 #

Azure App Service基于Host头路由请求，私有链接域名（如mywebapp.privatelink.azurewebsites.net）默认未被App Service识别为有效主机名，导致请求被路由到默认站点返回404；此外私有端点的子资源配置错误也可能引发该问题。

快速验证方法 #

在curl请求中手动添加原始App Service域名的Host头，测试是否能正常响应：

curl -I http://mywebapp.privatelink.azurewebsites.net -H "Host: mywebapp.azurewebsites.net"

如果返回正常（如302跳转），则确认是Host头映射问题。

永久解决步骤 #

1. 添加私有链接域名为App Service自定义域名 #

• 登录Azure门户，进入目标App Service（mywebapp）
• 导航至自定义域名页面，点击添加自定义域名
• 输入私有链接域名mywebapp.privatelink.azurewebsites.net，系统会自动完成DNS验证（因已配置私有DNS区域）
• 完成添加后，App Service将识别该私有域名的Host头，直接访问即可正常响应

2. 检查私有端点配置 #

• 进入私有端点资源页面，确认目标资源类型为Microsoft.Web/sites，目标资源选择你的mywebapp
• 关键：子资源必须选择sites（若选择其他子资源如scm，仅能访问Kudu站点，导致主站点404）

3. 排查访问限制与VNet配置 #

• 若App Service设置了访问限制，确保允许私有端点所在VNet的IP范围，或直接启用“允许虚拟网络访问”选项
• 若启用了App Service的VNet集成，确认私有端点所在VNet与集成VNet已对等连接或为同一VNet

补充说明 #

• 若使用HTTPS访问私有链接域名，需确保该域名已绑定SSL证书（可使用App Service管理的证书）
• 私有DNS区域privatelink.azurewebsites.net需正确链接到私有端点所在的虚拟网络，确保DNS解析正常（你的nslookup结果已验证此步骤无误）

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