.NET8 Azure Functions迁移后函数无法识别问题求助

1. 确认独立运行模型的配置正确性 #

• 检查.csproj文件，确保包含以下核心配置，根据部署环境调整RuntimeIdentifier：

  <PropertyGroup>
    <TargetFramework>net8.0</TargetFramework>
    <AzureFunctionsVersion>v4</AzureFunctionsVersion>
    <PublishReadyToRun>true</PublishReadyToRun>
    <SelfContained>true</SelfContained>
    <RuntimeIdentifier>win-x64</RuntimeIdentifier>
  </PropertyGroup>
  

• 移除所有Microsoft.NET.Sdk.Functions之外的单独框架依赖包（如System.Linq等），依赖由独立运行时统一提供。

2. 修正Program.cs启动逻辑 #

• .NET8 Azure Functions采用顶级语句模式，无需单独的Startup.cs（特殊依赖注入需求除外），确保Program.cs结构如下：

  var host = new HostBuilder()
      .ConfigureFunctionsWorkerDefaults()
      .Build();
  
  host.Run();
  

• 如需自定义服务注入，直接在ConfigureFunctionsWorkerDefaults()后链式调用ConfigureServices()，不要保留旧版Startup.cs避免冲突。

3. 检查函数类与方法的正确性 #

• 确保函数类为public访问权限，函数方法使用正确的触发器特性：.NET8推荐使用[Function("FunctionName")]，兼容旧版[FunctionName("FunctionName")]。
• 触发器参数类型需匹配.NET8 Worker模型要求，比如HTTP触发器使用HttpRequestData而非旧版HttpRequest，示例：

  public class DemoFunction
  {
      [Function("HttpTriggerDemo")]
      public HttpResponseData Run([HttpTrigger(AuthorizationLevel.Anonymous, "get")] HttpRequestData req)
      {
          var response = req.CreateResponse(System.Net.HttpStatusCode.OK);
          response.WriteString("运行正常");
          return response;
      }
  }
  

4. 清理本地运行环境 #

• 删除项目根目录下的bin和obj文件夹，重新构建解决方案。
• 重启Azure Functions本地运行时，执行命令：

  func stop
  func start
  

5. 验证Azure门户配置 #

• 登录Azure门户，确认函数应用的设置中：FUNCTIONS_EXTENSION_VERSION为~4，DOTNET_VERSION为8.0。
• 独立部署时，确保部署包包含完整运行时文件，不要勾选「仅部署项目文件」选项。

6. 排查依赖注入冲突 #

• 若之前添加了Startup.cs，尝试移除并将配置逻辑合并到Program.cs中，.NET8 Functions宿主模型不兼容旧版Startup.cs的注册方式。
• 暂时移除非必要的自定义中间件或服务注册，逐步排查是否有注册逻辑导致宿主无法扫描到函数。

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