Azure Functions中HttpTrigger如何实现自定义模型绑定处理日期格式问题

全局自定义DateTime格式处理 #

可以实现，Azure Function的模型绑定底层依赖System.Text.Json（隔离进程模型默认）或Newtonsoft.Json（进程内模型默认），你可以通过自定义JSON转换器实现全局日期格式统一处理：
首先实现自定义DateTime转换器：

using System.Text.Json;
using System.Text.Json.Serialization;
using System.Globalization;

public class CustomDateTimeConverter : JsonConverter<DateTime>
{
    // 替换为你需要的日期格式
    private const string TargetFormat = "yyyy-MM-dd HH:mm:ss";

    public override DateTime Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options)
    {
        var dateStr = reader.GetString();
        if (DateTime.TryParseExact(dateStr, TargetFormat, CultureInfo.InvariantCulture, DateTimeStyles.None, out var result))
        {
            return result;
        }
        throw new JsonException($"仅支持格式为 {TargetFormat} 的日期字符串");
    }

    public override void Write(Utf8JsonWriter writer, DateTime value, JsonSerializerOptions options)
    {
        writer.WriteStringValue(value.ToString(TargetFormat, CultureInfo.InvariantCulture));
    }
}

全局注册方式：

• 隔离进程模型：在Program.cs中添加配置

var host = new HostBuilder()
    .ConfigureFunctionsWorkerDefaults()
    .ConfigureServices(services =>
    {
        services.Configure<JsonSerializerOptions>(options =>
        {
            options.Converters.Add(new CustomDateTimeConverter());
            // 如果POCO中字段确实为string类型，可加下面配置避免自动解析日期
            // options.DisableDateParsing = true;
        });
    })
    .Build();

host.Run();

• 进程内模型：在Startup.cs中配置对应JSON序列化器的全局转换器即可。

单个端点单独配置规则 #

可以实现，有两种常用方案：

方案1：给对应端点的POCO加特性标记 #

如果该端点用单独的POCO接收参数，直接给字段或整个POCO加转换器特性即可，不影响其他接口：

public class MySpecificEndpointRequest
{
    [JsonConverter(typeof(CustomDateTimeConverter))]
    public DateTime CreateTime { get; set; }
    public string OtherProperty { get; set; }
}

方案2：手动反序列化单个接口的请求 #

如果不想改动POCO定义，也可以跳过自动模型绑定，在目标端点内手动读取请求体，用自定义配置反序列化：

[FunctionName("CustomDateEndpoint")]
public async Task<IActionResult> Run(
    [HttpTrigger(AuthorizationLevel.Function, "post")] HttpRequest req)
{
    var requestBody = await new StreamReader(req.Body).ReadToEndAsync();
    var serializeOptions = new JsonSerializerOptions();
    serializeOptions.Converters.Add(new CustomDateTimeConverter());
    var requestData = JsonSerializer.Deserialize<MyPoco>(requestBody, serializeOptions);
    // 后续业务逻辑
}

补充说明 #

你提到POCO中字段定义为string类型仍触发日期解析错误，是因为JSON序列化器默认会自动识别符合日期格式的字符串并尝试转换为DateTime类型，你可以在序列化配置中开启DisableDateParsing（System.Text.Json）或设置DateParseHandling = DateParseHandling.None（Newtonsoft.Json），即可直接将原始字符串赋值给string字段，也能解决该报错。 #

内容的提问来源于stack exchange，提问作者Oskar Jensson Fjeld