Azure Functions中不使用dynamic返回键值对JSON响应的方案

核心思路是自定义返回结果类，直接控制序列化输出内容，避免框架自动序列化结果类本身，同时保留强类型特性：

1. 自定义泛型OkResultWithValue类（基于IResult接口，推荐.NET 6+） #

IResult是Azure Functions轻量返回接口，通过实现它可以完全控制响应输出：

using Microsoft.AspNetCore.Http;
using System.Text.Json;
using System.Threading.Tasks;

public class OkResultWithValue<T> : IResult
{
    private readonly T _responseValue;

    public OkResultWithValue(T value)
    {
        _responseValue = value;
    }

    public async Task ExecuteAsync(HttpContext httpContext)
    {
        // 设置响应状态码和内容类型
        httpContext.Response.StatusCode = StatusCodes.Status200OK;
        httpContext.Response.ContentType = "application/json";

        // 直接序列化业务对象，而非当前结果类
        await JsonSerializer.SerializeAsync(
            httpContext.Response.Body,
            _responseValue,
            new JsonSerializerOptions
            {
                PropertyNamingPolicy = JsonNamingPolicy.CamelCase, // 可选：转小驼峰命名
                WriteIndented = false // 输出紧凑格式JSON
            });
    }
}

2. 扩展方法简化调用 #

写个静态扩展方法，让强类型对象可以快速转换为自定义结果：

public static class ResultExtensions
{
    public static OkResultWithValue<T> OkWithValue<T>(this T value)
    {
        return new OkResultWithValue<T>(value);
    }
}

3. 在Azure Function中使用 #

直接返回强类型对象的自定义结果，输出就是简洁的键值对JSON：

using Microsoft.AspNetCore.Http;
using Microsoft.AspNetCore.Mvc;
using Microsoft.Azure.WebJobs;
using Microsoft.Azure.WebJobs.Extensions.Http;

public static class SampleFunction
{
    [FunctionName("GetSampleData")]
    public static IResult Run(
        [HttpTrigger(AuthorizationLevel.Anonymous, "get", Route = null)] HttpRequest req)
    {
        // 强类型业务对象（可以是自定义实体类）
        var sampleData = new 
        { 
            UserId = 123, 
            UserName = "john_doe", 
            IsActive = true 
        };

        return sampleData.OkWithValue();
    }
}

旧版框架兼容方案（基于IActionResult） #

如果使用的是.NET 5及以前的Azure Functions，可继承ActionResult实现：

using Microsoft.AspNetCore.Mvc;
using System.Text.Json;
using System.Threading.Tasks;

public class OkResultWithValue<T> : ActionResult
{
    private readonly T _responseValue;

    public OkResultWithValue(T value)
    {
        _responseValue = value;
    }

    public override async Task ExecuteResultAsync(ActionContext context)
    {
        var httpContext = context.HttpContext;
        httpContext.Response.StatusCode = StatusCodes.Status200OK;
        httpContext.Response.ContentType = "application/json";

        await JsonSerializer.SerializeAsync(
            httpContext.Response.Body,
            _responseValue,
            new JsonSerializerOptions
            {
                PropertyNamingPolicy = JsonNamingPolicy.CamelCase,
                WriteIndented = false
            });
    }
}

效果说明 #

这样返回的JSON就是业务对象的直接序列化结果，比如：

{"userId":123,"userName":"john_doe","isActive":true}

完全没有额外包装属性，和使用dynamic的输出一致，但全程使用强类型，避免dynamic的类型安全问题。

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