.NET 6迁移至.NET 8 Azure Function应用：找不到作业函数求助

问题重现 #

迁移Azure Function项目从.NET 6到.NET 8后，启动时出现错误：

No job functions found. Try making your job classes and methods public. If you're using binding extensions (e.g. Azure Storage, ServiceBus, Timers, etc.) make sure you've called the registration method for the extension(s) in your startup code (e.g. builder.AddAzureStorage(), builder.AddServiceBus(), builder.AddTimers(), etc.)

深度排查步骤 #

• 确认项目运行模式与配置匹配

  • 检查.csproj文件：确保<TargetFramework>为net8.0，<AzureFunctionsVersion>为v4。
  • 区分进程内模式和隔离进程模式：
    • 进程内模式：需确保Program.cs使用WebApplication构建器，且注册Azure Functions：

      var builder = WebApplication.CreateBuilder(args);
      builder.Services.AddAzureFunctions();
      // 注册绑定扩展，如builder.AddAzureStorage();
      var app = builder.Build();
      app.Run();
      

    • 隔离进程模式：需使用HostBuilder，且绑定扩展注册在ConfigureFunctionsWorkerDefaults之后：

      var host = new HostBuilder()
          .ConfigureFunctionsWorkerDefaults()
          .AddAzureStorage() // 对应绑定扩展的注册方法
          .Build();
      host.Run();
      

  • 移除旧的[assembly: FunctionsStartup(typeof(Startup))]属性（进程内模式.NET 8已不再需要）。

• 验证函数类与方法的正确性

  • 函数类和方法必须为public访问修饰符，不能是internal或private。
  • 注意模式对应的属性差异：
    • 进程内模式：使用[FunctionName("FunctionName")]修饰方法。
    • 隔离进程模式：使用[Function("FunctionName")]修饰方法（而非旧的FunctionName）。
  • 隔离模式下，函数方法参数需使用FunctionContext替代ILogger，示例：

    public void Run([TimerTrigger("0 */5 * * * *")] TimerInfo myTimer, FunctionContext context)
    {
        var logger = context.GetLogger("MyTimerFunction");
        logger.LogInformation("Function executed");
    }
    

• 绑定扩展与NuGet包检查

  • 确保所有Azure Functions相关NuGet包版本兼容.NET 8，且版本统一：
    • 进程内模式：Microsoft.NET.Sdk.Functions需更新至最新兼容版本。
    • 隔离进程模式：Microsoft.Azure.Functions.Worker、Microsoft.Azure.Functions.Worker.Sdk及对应扩展包（如Microsoft.Azure.Functions.Worker.Extensions.Storage）版本一致。
  • 卸载冲突的旧包（如Microsoft.Azure.WebJobs系列包），避免跨模式包混用。

• 清理与重建项目

  • 删除项目根目录下的bin、obj文件夹。
  • 清理NuGet缓存：执行命令 dotnet nuget locals all --clear。
  • 重新构建项目，确保无编译错误。

• 启用调试日志定位细节

  • 修改host.json启用Debug级日志：

    {
      "logging": {
        "logLevel": {
          "default": "Debug",
          "Microsoft.Azure.Functions.Worker": "Debug"
        }
      }
    }
    

  • 本地启动函数，查看输出窗口的详细日志，定位是否有绑定加载失败、属性配置错误等具体问题。

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