Azure Function（Linux）ZipDeploy部署后函数无法加载求助

问题背景 #

原Windows主机通过ZipDeploy流程部署.NET 8 Azure Function App正常，切换至Linux主机后，部署返回200 OK，但Azure门户概览面板加载缓慢、无法显示函数列表，触发超时；本地运行正常，直接从Visual Studio部署也出现相同问题，已设置WEBSITE_RUN_FROM_PACKAGE=1，诊断面板显示部署状态异常。

排查与修复步骤 #

1. 校验部署包结构 #

Linux环境对部署包结构要求严格，需确保：

• 包根目录包含host.json、函数子文件夹，以及编译后的bin目录（含所有依赖程序集）
• 排除Windows特有的冗余文件（如.pdb、Windows版本的.config文件）
• 函数子文件夹内的function.json配置正确，尤其是Service Bus触发器的connection字段需与应用设置中的键名完全匹配（Linux环境键名区分大小写）

2. 调整WEBSITE_RUN_FROM_PACKAGE配置 #

• 若使用本地ZipDeploy推送，尝试将配置值改为存储账户SAS URL（将zip包上传至Azure存储容器后生成SAS链接），避免本地推送可能出现的权限或路径解析问题
• 确认配置值为1时，部署包已被Azure正确提取，可通过Kudu站点（https://<your-function-app>.scm.azurewebsites.net）的DebugConsole查看site/wwwroot目录结构

3. 查看实时运行日志 #

进入Azure门户「函数应用>监测>日志流」，重点排查：

• Host.Startup相关日志，确认是否存在程序集加载失败、配置文件读取错误
• Service Bus触发器初始化日志，检查连接字符串是否有效、队列权限是否配置正确
• 搜索FunctionInvocationException或TimeoutException，定位具体启动阻塞点

4. 修正Visual Studio发布配置 #

• 发布时选择「Azure Function App (Linux)」目标类型，而非Windows版本
• 在发布设置中勾选「Run from package file (recommended)」，让Visual Studio自动生成符合Linux要求的部署包
• 编辑.pubxml文件，添加排除规则减少包大小：

  <ExcludeFilesFromDeployment>*.pdb;*.xml</ExcludeFilesFromDeployment>
  

5. 验证运行时配置 #

确保host.json包含.NET 8隔离运行时配置：

{
  "version": "2.0",
  "runtime": {
    "dotnet-isolated": {
      "version": "8.0"
    }
  }
}

6. 检查App Service计划资源 #

• 确认使用的App Service计划为B1及以上规格（免费/共享计划资源受限易导致超时）
• 在「App Service计划>监测>指标」中查看CPU、内存使用率，若资源耗尽需升级实例规格

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