Azure Function App发布后门户中无函数显示问题求助

基础信息 #

• 环境：.NET 8 Isolated模式，所有包为当前版本，也尝试过Function App CLI工具生成的模板版本
• 部署方式：采用Function App与非文件共享存储账户部署，配置WEBSITE_RUN_FROM_PACKAGE环境变量
• 权限配置：Function App标识拥有存储账户的Storage Blob Owner权限
• 发布流程：通过Github Action完成，步骤如下：

- name: Build dotnet Core Function App
  run: dotnet build -c Release
  working-directory: /home/runner/work/core/core/NetCore

- name: Publish dotnet Core Function App
  run: dotnet publish -o /home/runner/work/output/dotnet-fa /p:UseAppHost=false
  working-directory: /home/runner/work/core/core/NetCore

- name: 'Upload Dot Net Function regardlessDec弹
施加海地成员保证函数/D供
  uses: Azure/functions-action@v1.5.2
  id: fa
  with:
    app-name: func-app-dotnet-${{ inputs.targetEnvironment }}
    package: '/home/runner/work/core/core/artifacts/dotnet-fa/.'

• 本地验证：在VS Code、VS2022及DevContainers中均可正常运行，无错误
• Azure端状态：无任何错误日志（已查看所有跟踪日志），文件界面显示包已正确解压，文件齐全
• 其他异常：通过VS2022直接发布时，弹出提示需更新运行时，但函数应用配置无任何变更

排查方向建议 #

1. 发布路径一致性校验
   注意到Github Action中，dotnet publish的输出目录为/home/runner/work/output/dotnet-fa，但上传步骤指定的包路径是/home/runner/work/core/core/artifacts/dotnet-fa/.，路径不匹配会导致上传空包或错误内容。需统一两个路径，例如将上传步骤的package参数修改为/home/runner/work/output/dotnet-fa。

2. 运行时版本匹配检查

   • 确认Function App配置中FUNCTIONS_EXTENSION_VERSION为~4（.NET 8 Isolated模式依赖Functions Runtime 4.x），同时DOTNET_VERSION设置为8.0.x
   • 核对本地.NET SDK版本与Azure运行时版本是否完全一致，避免版本差异引发的兼容问题

3. WEBSITE_RUN_FROM_PACKAGE配置验证

   • 确认该环境变量值为存储账户中包文件的完整HTTPS URL（格式：https://<storage-account>.blob.core.windows.net/<container>/<package-name>.zip），而非相对路径或本地路径
   • 检查存储账户网络配置：若Function App在虚拟网络内，需确保虚拟网络已允许访问存储账户；测试阶段可临时开启存储账户的“允许所有网络访问”权限，验证是否为网络隔离导致的包加载失败

4. 深层日志捕获

   • 在Azure门户开启函数应用的详细错误日志：进入“监测”>“日志”，启用“详细错误消息”和“应用日志记录（文件系统）”，重启应用后查看启动阶段的隐藏错误
   • 使用Azure CLI执行az functionapp log tail --name <app-name> --resource-group <rg-name>，实时捕获门户日志未显示的启动异常；也可通过Kudu的Debug Console查看LogFiles目录下的原生启动日志

5. 存储权限有效性验证

   • 确认Function App的系统标识已正确关联到存储账户的IAM角色，且角色分配范围覆盖目标容器
   • 临时使用存储账户访问密钥配置WEBSITE_RUN_FROM_PACKAGE，验证是否为托管标识权限问题导致无法加载包

6. VS2022运行时提示的深层排查

   • VS2022的运行时更新提示，可能源于本地Functions Core Tools版本与Azure Functions Runtime版本不匹配。更新本地Core Tools至最新版本后重新 chart
     井应用的（P /min（方方面面`EA，手动选择最新的4.x Runtime版本

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