Azure Functions切换高级App Service计划后部署及运行故障求助

1 配置项正确性校验 #

• WEBSITE_CONTENTAZUREFILECONNECTIONSTRING：必须填写存储函数元数据的Azure存储账户真实连接字符串，禁止使用示例占位值。存储账户需与函数应用处于同一Azure区域，若存储账户开启网络访问控制，需允许函数应用访问。
• WEBSITE_CONTENTSHARE：取值为存储账户中存储函数代码的文件共享名称，仅支持小写字母、数字和短横线，不可直接复用含大写/特殊字符的函数应用名。如果是首次配置该参数，直接填写全小写的函数应用名即可，系统会自动创建对应文件共享。

2 网络规则排查 #

• 若高级App Service计划开启了VNet集成，需确认存储账户的防火墙规则已放行该VNet对应的子网，或存储账户已开启「允许受信任的Azure服务访问」开关。
• 从函数应用的「属性」面板导出所有出站IP段，全部添加到存储账户的防火墙白名单中，避免出站流量被拦截导致无法拉取元数据。
• 不要在函数应用的入站IP限制规则中封禁本地环回地址与Azure内部服务网段，否则会导致运行时自检失败。

3 部署与运行时验证 #

• 所有配置修改后保存，重启函数应用，等待3-5分钟后刷新Azure门户，确认「Azure Functions runtime is unreachable」报错是否消除。
• 本地部署前可先通过门户的Kudu高级工具控制台执行func --version，确认运行时状态正常后再执行部署操作。
• 本地部署报SyntaxError: Unexpected token S in JSON at position 0的本质是请求返回了503服务不可用的HTML页面，而非预期的JSON响应，运行时启动恢复后该报错会自动消失。

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