无法将Function App发布至Linux，报错HTTP状态码Unauthorized

1. 校验发布配置文件有效性 #

• 直接从Azure门户下载Function App的官方发布配置文件（概述页「获取发布配置文件」），替换VS中旧的配置文件，避免自动生成的配置存在参数偏差。
• 确认配置文件里的发布方法为Zip Deploy，身份验证选择应用程序级别凭据，不要用用户级别凭据——Linux实例对权限范围的校验比Windows更严格。

2. 核查部署权限 #

• 检查你的Azure账号对目标Function App是否拥有网站参与者或更高权限，缺少部署权限会直接触发授权失败。
• 如果用服务主体部署，确认服务主体已被分配对应角色，且VS发布时选择了正确的服务主体身份验证方式。

3. 确保项目与Linux实例兼容 #

• 核对项目目标框架和Azure实例上的FUNCTIONS_EXTENSION_VERSION配置完全一致（比如均为.NET 6或.NET 8），Linux实例对运行时版本的兼容性要求比Windows更严格。
• 手动打包项目（右键项目→发布→创建包），通过Azure门户「高级工具(Kudu)」→「部署」→「Zip部署」上传测试：手动上传成功则说明VS发布流程有问题，失败则聚焦包本身或实例配置。

4. 排查网络限制 #

• 检查本地防火墙、代理是否拦截了VS与Azure Linux实例的通信，Linux部署端点和Windows不同，容易被本地规则限制。
• 在Azure门户查看Function App的「网络配置」，确认未设置「限制出站流量」或IP范围限制，避免部署请求被实例端拦截。

5. 提取详细错误日志定位问题 #

• VS发布失败时，点击「查看日志」复制完整错误信息，重点关注401/403状态码对应的权限提示，或500状态码对应的实例配置异常提示。
• 在Azure门户开启Function App的「应用服务日志」（文件系统日志），重新发布后查看实例端的部署日志，获取更底层的失败原因。

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