.NET6 V4 Azure Functions Worker升级中HttpResponseData扩展方法异常问题

问题本质 #

升级到Worker模型后，调用WriteAsJsonAsync时抛出“无法从服务提供器获取对象序列化器”异常，原因是Worker模型的JSON序列化服务需要手动在DI容器中注册，不像旧版In-Process模型自动复用MVC的配置。

分步解决 #

1. 在Program.cs配置序列化服务 #

Worker模型的核心配置都在Program.cs里，必须添加序列化器的注册和配置：

var host = new HostBuilder()
    .ConfigureFunctionsWorkerDefaults(builder =>
    {
        // 按项目需求配置JSON序列化规则
        builder.Services.Configure<JsonSerializerOptions>(options =>
        {
            options.PropertyNamingPolicy = JsonNamingPolicy.CamelCase;
            options.PropertyNameCaseInsensitive = true;
            // 可添加其他配置，比如忽略空值：options.DefaultIgnoreCondition = JsonIgnoreCondition.WhenWritingNull;
        });
        
        // 注册Worker依赖的序列化服务，这是解决异常的关键
        builder.Services.AddSingleton<IModelSerializer, DefaultModelSerializer>();
    })
    .Build();

host.Run();

2. 修复ToCustomResponse扩展方法 #

可以直接从DI容器获取序列化器，替代依赖WriteAsJsonAsync的默认逻辑，也能保证兼容性：

public static async Task<HttpResponseData> ToCustomResponse(this HttpResponseData response, object data, JsonSerializerOptions options = null)
{
    // 从FunctionContext的DI容器中获取序列化器
    var serializer = response.FunctionContext.InstanceServices.GetRequiredService<IModelSerializer>();
    var jsonOptions = options ?? response.FunctionContext.InstanceServices.GetRequiredService<IOptions<JsonSerializerOptions>>().Value;
    
    await serializer.SerializeAsync(response.Body, data, jsonOptions);
    response.Headers.Add("Content-Type", "application/json; charset=utf-8");
    return response;
}

如果坚持使用WriteAsJsonAsync，只要完成上面Program.cs的配置，该方法就能自动从DI容器获取序列化器，无需修改调用逻辑。

3. 替换旧版ActionResult为HttpResponseData #

旧版MVC风格的返回类型（比如NotFoundResult）要适配Worker模型的写法：

// 旧版MVC代码
public IActionResult Get()
{
    return NotFound();
}

// 新版Worker代码
public async Task<HttpResponseData> Get([HttpTrigger(AuthorizationLevel.Anonymous, "get")] HttpRequestData req, FunctionContext context)
{
    var notFoundResp = req.CreateResponse(HttpStatusCode.NotFound);
    await notFoundResp.ToCustomResponse(new { Message = "资源不存在" });
    return notFoundResp;
}

4. 检查NuGet包版本 #

确保所有Worker相关的包版本一致，避免混用新旧版本：

• Microsoft.Azure.Functions.Worker
• Microsoft.Azure.Functions.Worker.Sdk
• Microsoft.Azure.Functions.Worker.Extensions.Http
  直接通过NuGet管理器更新到最新稳定版即可。

重要提醒 #

Worker模型和旧版In-Process模型的DI、序列化逻辑完全独立，不能直接复用旧版MVC的配置，必须按Worker的规则重新配置序列化服务，这是升级时的常见坑点。

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