.NET 8项目使用Google.Cloud.Functions.Hosting时IFunctionsHostBuilder未识别

问题背景 #

开发.NET 8项目时，使用Google.Cloud.Functions.Hosting构建Google Cloud Functions，已配置Startup.cs和appsettings.json，但始终提示IFunctionsHostBuilder未找到（错误CS0246）。已尝试确认目标框架为.NET 8、清理重建、dotnet restore、重启IDE等操作，问题仍存在。

相关代码及配置如下：

Startup.cs #

using Google.Cloud.Functions.Hosting;
using ShakeSafe.ServerFunctions;
using Microsoft.Extensions.Options;

public class Startup : FunctionsStartup
{
    public override void Configure(IFunctionsHostBuilder builder)
    {
        builder.Services.AddHttpClient();
        builder.Services.Configure<SeismicDataOptions>(options =>
        {
            options.BaseUrl = Environment.GetEnvironmentVariable("BASE_URL");
        });
    }
}

.csproj #

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <TargetFramework>net8.0</TargetFramework>
    <ImplicitUsings>enable</ImplicitUsings>
    <Nullable>enable</Nullable>
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="Google.Cloud.Diagnostics.AspNetCore" Version="4.4.0" />
    <PackageReference Include="Google.Cloud.Functions.Hosting" Version="2.1.0" />
    <PackageReference Include="Google.Events.Protobuf" Version="1.5.0" />
    <PackageReference Include="Microsoft.Extensions.Logging" Version="8.0.0" />
    <PackageReference Include="System.Net.Http" Version="4.3.4" />
  </ItemGroup>

  <ItemGroup>
    <None Remove="Services\" />
    <None Remove="Functions\" />
    <None Remove="Models\" />
    <None Remove="Tests\" />
  </ItemGroup>
  <ItemGroup>
    <Folder Include="Services\" />
    <Folder Include="Functions\" />
    <Folder Include="Models\" />
    <Folder Include="Tests\" />
  </ItemGroup>
  <ItemGroup>
    <None Update="appsettings.json">
      <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
    </None>
  </ItemGroup>
</Project>

appsettings.json #

{
  "SeismicDataOptions": {
    "BaseUrl": "https://geofon.gfz-potsdam.de/fdsnws/event/1/query"
  }
}

解决方案 #

1. 升级NuGet包版本 #

Google.Cloud.Functions.Hosting 2.x版本仅兼容.NET 6/7，.NET 8需要使用3.x及以上版本。更新.csproj中的包引用：

<PackageReference Include="Google.Cloud.Functions.Hosting" Version="3.0.0" />

执行dotnet restore确保包更新完成。

2. 调整Startup.cs的Configure方法签名 #

3.x版本中，FunctionsStartup的Configure方法参数已从IFunctionsHostBuilder改为FunctionsHostBuilderContext，通过上下文对象获取服务集合：

using Google.Cloud.Functions.Hosting;
using ShakeSafe.ServerFunctions;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.DependencyInjection;

public class Startup : FunctionsStartup
{
    public override void Configure(FunctionsHostBuilderContext context)
    {
        // 添加HttpClient
        context.Services.AddHttpClient();
        
        // 从配置绑定选项（自动读取appsettings.json和环境变量）
        context.Services.Configure<SeismicDataOptions>(
            context.Configuration.GetSection(nameof(SeismicDataOptions)));
    }
}

这样既可以自动读取appsettings.json中的配置，也会优先读取同名环境变量（符合Cloud Functions的配置习惯），无需手动调用Environment.GetEnvironmentVariable。

3. 验证依赖兼容性 #

确保其他相关包也兼容.NET 8，比如Google.Cloud.Diagnostics.AspNetCore可以升级到5.x版本（兼容.NET 8）：

<PackageReference Include="Google.Cloud.Diagnostics.AspNetCore" Version="5.0.0" />

完成以上步骤后，清理重建项目即可解决IFunctionsHostBuilder未找到的问题。

内容的提问来源于stack exchange，提问作者Güliz Hasan