Azure隔离函数返回完整上下文而非预期JSON的修复咨询

问题根源 #

Azure函数的隔离进程模型与进程内模型对Http触发器的处理逻辑存在差异：

• 进程内模型中，HttpTrigger绑定的是Microsoft.AspNetCore.Http.HttpRequest，返回IActionResult时框架会自动完成序列化处理并设置正确响应头。
• 隔离进程模型中，默认HttpTrigger绑定的是Microsoft.Azure.Functions.Worker.Http.HttpRequestData，直接返回IActionResult会被框架序列化为该对象自身的结构（即你看到的包含Value、Formatters的JSON），同时默认响应头的Content-Type会被设为text/plain; charset=utf-8。

修复方案 #

方案1：使用原生隔离模式API构建响应 #

直接借助HttpRequestData创建响应，手动完成对象序列化并设置正确的响应头，无需额外依赖：

[Function("GetSync")]
public async Task<HttpResponseData> GetSync(
    [HttpTrigger(AuthorizationLevel.Anonymous, "get", Route = "getsync/{Id:guid}")] HttpRequestData req, Guid Id)
{
     var responseObject = new { Message = "Hello, world!", TimeStamp = DateTime.Now };
     // 创建200状态码的响应实例
     var response = req.CreateResponse(System.Net.HttpStatusCode.OK);
     // 将对象序列化为JSON并写入响应，自动设置Content-Type为application/json
     await response.WriteAsJsonAsync(responseObject);
     return response;
}

方案2：启用AspNetCore集成（兼容进程内写法） #

通过安装官方扩展包，让隔离进程模型支持IActionResult和HttpRequest的用法，直接复用原有进程内代码逻辑：

1. 安装NuGet包：

Install-Package Microsoft.Azure.Functions.Worker.Extensions.Http.AspNetCore

2. 修改Program.cs配置AspNetCore中间件：

var host = new HostBuilder()
    .ConfigureFunctionsWorkerDefaults(builder =>
    {
        // 添加Http中间件以支持AspNetCore集成特性
        builder.UseHttpMiddleware();
    })
    .Build();

host.Run();

3. 修改函数代码（可继续使用IActionResult返回）：

[Function("GetSync")]
public async Task<IActionResult> GetSync(
    [HttpTrigger(AuthorizationLevel.Anonymous, "get", Route = "getsync/{Id:guid}")] HttpRequest req, Guid Id)
{
     var responseObject = new { Message = "Hello, world!", TimeStamp = DateTime.Now };
     return new OkObjectResult(responseObject);
}

两种方案均可让函数返回预期的JSON对象，并自动设置正确的Content-Type: application/json响应头。

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