Azure Functions为何普遍用NewtonSoft而非System.Text.Json？能否改用后者？

一、为何Azure Functions默认不支持System.Text.Json，示例普遍采用NewtonSoft？ #

• 历史兼容性：Azure Functions早期基于.NET Framework构建，NewtonSoft.Json（Json.NET）是当时.NET生态中事实标准的JSON处理库，微软官方框架及第三方工具普遍依赖它，因此初始版本就将其作为默认序列化工具。
• 功能成熟度：System.Text.Json推出初期，在复杂类型序列化、自定义转换器支持、兼容性处理等方面不如NewtonSoft完善。Azure Functions为保障稳定性和广泛兼容性，选择延续使用NewtonSoft作为默认配置。
• 生态迁移成本：大量现有Azure Functions项目、官方文档及社区示例均基于NewtonSoft开发，直接切换默认库会导致大量已有代码出现兼容性问题，因此微软采取逐步过渡的策略，而非直接替换默认依赖。

二、能否在Azure Functions中使用System.Text.Json替代NewtonSoft？ #

完全可以，以下两种方式实现替换：

1. 手动替换序列化逻辑 #

直接在代码中使用System.Text.Json的API处理JSON序列化/反序列化，修改后的示例代码如下：

using System.Text.Json;

public static class FanyFunctionName
{
    [FunctionName("FanyFunctionName")]
    public static async Task<IActionResult> Run(
        [HttpTrigger(AuthorizationLevel.Function, "post", Route = null)]
        HttpRequest req,
        ILogger log)
    {
        try
        {
            // 使用System.Text.Json反序列化请求体
            var eventObject = await JsonSerializer.DeserializeAsync<Event>(req.Body);

            // 记录事件类型等必要信息
            return new OkResult();
        }
        catch (Exception ex)
        {
            log.LogError(ex, "Error processing event");
            return new BadRequestObjectResult("Error processing event");
        }
    }
}

注：可通过JsonSerializerOptions配置序列化规则（如大小写匹配、日期格式等），对齐NewtonSoft的默认行为。

2. 配置默认序列化器（.NET 6+ In-Process模型） #

若希望全局替换Azure Functions的默认JSON序列化器，可通过依赖注入配置JsonSerializerOptions：

using Microsoft.Azure.Functions.Extensions.DependencyInjection;
using Microsoft.Extensions.DependencyInjection;
using System.Text.Json;

[assembly: FunctionsStartup(typeof(YourNamespace.Startup))]
namespace YourNamespace
{
    public class Startup : FunctionsStartup
    {
        public override void Configure(IFunctionsHostBuilder builder)
        {
            builder.Services.Configure<JsonSerializerOptions>(options =>
            {
                options.PropertyNameCaseInsensitive = true; // 匹配NewtonSoft默认的不区分大小写规则
                options.DefaultIgnoreCondition = JsonIgnoreCondition.WhenWritingNull; // 忽略空值属性
                // 添加其他自定义配置
            });
        }
    }
}

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