访问已部署Azure函数Kudu报403 Forbidden及发布失败问题

故障现象 #

• 访问已部署Azure函数对应的Kudu服务时返回forbidden错误，直接通过浏览器访问也返回相同报错
• 采用zip包方式发布函数时，收到如下报错：

Publish has encountered an error. The Publish URL https://adxiprocfuncria01euwprd.scm.azurewebsites.net/ is unreachable. The application may be stopped, restarting or unavailable. Try again once the publish target is available.

• 已尝试将自身客户端IP添加到访问允许列表，问题未解决
• 访问不带scm路径的主站点地址可正常收到App Service可用提示，仅带scm路径的Kudu地址返回forbidden错误
• 从Azure门户下载的发布配置文件中，记录的发布URL与实际使用的地址完全一致
• 报错截图如下：
  

解决步骤 #

• 优先核对SCM站点独立访问限制配置：Azure App Service主站点与SCM（Kudu）站点的访问限制规则相互独立，此前添加的IP白名单若仅配置在主站点，不会对SCM站点生效。进入Azure门户对应函数应用的「网络」-「访问限制」页面，切换到SCM站点标签页，将客户端公网IP添加为允许规则，确保规则优先级高于所有拒绝规则。
• 检查SCM站点认证配置：若函数应用配置了Azure AD或第三方身份提供商强制认证，且SCM站点继承认证策略但未配置对应访问权限，会直接返回403。进入「认证」页面查看SCM站点的认证授权设置，临时关闭SCM独立认证强制策略验证访问是否恢复。
• 核对平台配置项：进入「配置」-「常规设置」页面，确认SCM_TYPE配置项未被修改为非默认值，不存在错误的部署源配置导致SCM站点被锁定。
• 排查虚拟网络/私有端点配置：若函数应用配置了VNet集成、私有端点，确认SCM站点公网访问未被完全禁用——SCM站点若设置为「仅允许私有端点访问」，公网发起的访问会直接返回403。该场景下要么从同VNet内的设备访问Kudu，要么在SCM访问限制中放开对应公网访问权限。
• 上述配置均确认无异常时，在函数应用「概述」页手动点击重启按钮，等待3-5分钟SCM站点完全启动后再尝试访问、发布操作。部分场景下SCM站点进程异常卡死会持续返回403，重启即可恢复。
• 重启后问题仍存在的，进入「诊断并解决问题」页面搜索「SCM 403」，运行平台内置诊断工具，可直接定位到配置错误、访问拦截或平台侧故障等根因。

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