升级至.NET 8后Azure Function仍显示.NET 6？问题排查与确认

1. 为何Kudu环境仍显示.NET 6运行时？ #

Kudu（高级工具）的运行环境与Azure Functions的实际执行环境相互独立：

• 函数应用门户设置的堆栈版本仅作用于函数代码运行的沙箱环境，不会自动同步更新Kudu使用的基础App Service runtime。
• 若函数采用**隔离进程（OutOfProcess）**部署，函数自身会携带独立的.NET运行时，而Kudu仍使用App Service宿主环境默认的.NET版本，两者自然不一致。
• 消耗计划等共享宿主环境中，Kudu的.NET版本由平台统一维护，不会随单个函数应用的堆栈设置变更而升级。

2. 如何确认Azure Function实际运行在.NET 8环境？ #

可通过以下方式验证：

• 代码日志输出：在函数代码中添加日志语句，打印当前运行框架信息：

  using System.Runtime.InteropServices;
  // 在函数方法内添加
  log.LogInformation($"当前运行框架: {RuntimeInformation.FrameworkDescription}");
  

  发布后查看函数应用的日志流或Application Insights，确认输出包含.NET 8.x。
• 启动日志检查：在Azure门户的函数应用→监控→日志流中，查找启动阶段日志，会显示类似Loading runtime version: 8.x.x的信息。
• 查看runtimeconfig.json：通过Kudu文件管理器进入site/wwwroot，查看项目对应的*.runtimeconfig.json文件，其中runtimeOptions.framework.version应为8.x.x。

3. 完成Azure Functions至.NET 8的升级是否需额外步骤？ #

是的，除修改项目TargetFramework和门户堆栈版本，还需完成以下关键步骤：

• 升级NuGet包：
  • 进程内模型：确保Microsoft.NET.Sdk.Functions包版本升级至4.1.0或更高（.NET 8兼容版本）。
  • 隔离进程模型：升级Microsoft.Azure.Functions.Worker、Microsoft.Azure.Functions.Worker.Sdk至1.19.0或更高版本。
• 确认Functions Runtime版本：在门户的配置→应用程序设置中，确保FUNCTIONS_EXTENSION_VERSION设置为~4（.NET 8对应Functions Runtime v4）。
• 调整部署模型配置（隔离进程）：若使用隔离进程，需在项目文件中添加或确认：

  <AspNetCoreHostingModel>OutOfProcess</AspNetCoreHostingModel>
  

• 重启函数应用：完成所有设置后，务必重启函数应用，确保配置变更生效。
• 清理旧部署文件：采用Zip部署或本地发布时，确保部署包仅包含.NET 8编译后的文件，删除残留的.NET 6相关文件。

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