.NET Framework 4.6迁移至.NET5后，[FromBody]绑定非可空GUID字段时实体为null的问题解决求助

这个问题我之前迁移项目时也碰到过，核心原因是.NET Core的模型绑定在遇到无法转换的非空值类型时，会直接导致整个实体绑定失败变成null，而.NET Framework时期的序列化/绑定行为会自动把这类无效值转成对应类型的默认值（比如Guid.Empty）。结合你的需求（不修改前端、尽量少改后端），可以通过配置Newtonsoft.Json的自定义转换器来解决：

步骤1：创建自定义GUID转换转换器 #

我们需要两个转换器，分别处理非空Guid和可空Guid?类型的反序列化：

using Newtonsoft.Json;
using System;

// 处理非空Guid：空字符串/无效值转为Guid.Empty
public class EmptyStringToEmptyGuidConverter : JsonConverter<Guid>
{
    public override Guid ReadJson(JsonReader reader, Type objectType, Guid existingValue, bool hasExistingValue, JsonSerializer serializer)
    {
        // 处理空字符串或null的情况
        if (reader.Value is string value && string.IsNullOrEmpty(value))
        {
            return Guid.Empty;
        }

        // 尝试转换，失败则返回Guid.Empty
        if (Guid.TryParse(reader.Value?.ToString(), out var result))
        {
            return result;
        }
        return Guid.Empty;
    }

    public override void WriteJson(JsonWriter writer, Guid value, JsonSerializer serializer)
    {
        writer.WriteValue(value.ToString());
    }
}

// 处理可空Guid：空字符串/无效值转为null
public class EmptyStringToNullGuidConverter : JsonConverter<Guid?>
{
    public override Guid? ReadJson(JsonReader reader, Type objectType, Guid? existingValue, bool hasExistingValue, JsonSerializer serializer)
    {
        if (reader.Value is string value && string.IsNullOrEmpty(value))
        {
            return null;
        }

        if (Guid.TryParse(reader.Value?.ToString(), out var result))
        {
            return result;
        }
        return null;
    }

    public override void WriteJson(JsonWriter writer, Guid? value, JsonSerializer serializer)
    {
        if (value.HasValue)
        {
            writer.WriteValue(value.Value.ToString());
        }
        else
        {
            writer.WriteNull();
        }
    }
}

步骤2：在Startup中配置Newtonsoft.Json #

修改ConfigureServices中的AddNewtonsoftJson配置，注册自定义转换器，同时确保支持[DataContract]和[DataMember]特性：

public void ConfigureServices(IServiceCollection services)
{
    services.AddCors(o => o.AddPolicy("MyPolicy", builder =>
    {
        builder.AllowAnyOrigin()
               .AllowAnyMethod()
               .AllowAnyHeader();
    }));
    
    // 合并AddControllers和AddNewtonsoftJson的配置，避免重复添加Mvc服务
    services.AddControllers(options =>
    {
        options.OutputFormatters.RemoveType<StringOutputFormatter>();
    })
    .AddNewtonsoftJson(options =>
    {
        // 启用对[DataContract]/[DataMember]的支持，匹配你的实体特性
        options.SerializerSettings.ContractResolver = new Newtonsoft.Json.Serialization.DataContractResolver();
        // 添加自定义转换器
        options.SerializerSettings.Converters.Add(new EmptyStringToEmptyGuidConverter());
        options.SerializerSettings.Converters.Add(new EmptyStringToNullGuidConverter());
        // 可选：忽略反序列化错误，防止其他类型的转换问题导致实体为null
        options.SerializerSettings.Error = (sender, args) =>
        {
            // 这里可以添加日志记录，方便排查其他问题
            args.ErrorContext.Handled = true;
        };
    });

    services.AddSwaggerGen();
    
    services.Configure<ApiBehaviorOptions>(options =>
    {
        options.SuppressModelStateInvalidFilter = true;
    });
}

为什么这个方案有效？ #

• 自定义转换器会在反序列化时拦截GUID类型的字段，将空字符串/无效值转为预期的默认值（Guid.Empty或null），而不是抛出异常
• 这样模型绑定就能成功完成，不会因为单个字段的转换失败导致整个实体变为null
• 完全基于配置修改，不需要改动现有的实体、控制器代码，符合你尽量少改代码的需求

额外注意事项 #

• 如果你之前的JsonConvert.DeserializeObject调用已经正常工作，这个配置也会兼容它，因为它使用的是同一个Newtonsoft.Json配置
• 不需要移除[FromBody]特性，它是正确接收JSON请求体的必要配置

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