升级后的Azure Function无法在门户测试及查看function.json

AI 小北

2026-8-4

Azure Function v4/.NET6升级后门户无法测试及查看function.json的解决办法

排查与修复步骤

验证部署包有效性
本地升级完成后，确保发布的是适配.NET6和Functions v4的包：
- 执行dotnet publish --configuration Release --output ./publish生成发布包，检查输出目录下的host.json是否包含正确的扩展包配置：
```
{
  "version": "2.0",
  "extensionBundle": {
    "id": "Microsoft.Azure.Functions.ExtensionBundle",
    "version": "[3.*, 4.0.0)"
  }
}
```
- 若用Visual Studio发布，确认发布配置的目标框架为.NET 6，Functions版本选择v4。
核对运行时应用设置
除已设置的FUNCTIONS_EXTENSION_VERSION=~4和.NET版本v6.0，需确认FUNCTIONS_WORKER_RUNTIME配置：
- 对于In-Process运行模型（原v3默认模式），该值应为dotnet
- 对于Isolated Worker运行模型，该值应为dotnet-isolated
  执行命令检查当前配置：
```
az functionapp config appsettings list -g <RESOURCE_GROUP_NAME> -n <APP_NAME> --query "[?name=='FUNCTIONS_WORKER_RUNTIME']"
```
配置错误时，执行命令修正：
```
az functionapp config appsettings set --settings FUNCTIONS_WORKER_RUNTIME=dotnet -g <RESOURCE_GROUP_NAME> -n <APP_NAME>
```
重启函数应用
配置变更后必须重启应用使设置生效：
```
az functionapp restart -g <RESOURCE_GROUP_NAME> -n <APP_NAME>
```
查看日志定位问题
通过门户的「日志流」（平台功能>日志流）或命令行查看实时日志：
```
az functionapp log tail -g <RESOURCE_GROUP_NAME> -n <APP_NAME>
```
查找启动失败、依赖缺失或配置错误等相关日志信息。
确认function.json存在性
登录Kudu站点，检查site/wwwroot下的函数目录中是否存在function.json：
- In-Process模型中，该文件由SDK自动生成，发布时应包含在对应函数目录下
- Isolated模型中，需确保项目配置了正确的元数据生成逻辑