ASP.NET中实现IParsable的嵌套对象Model Binding失败原因咨询

你遇到的问题根源在于ASP.NET Core默认使用的System.Text.Json序列化器，并不会自动对嵌套对象类型的属性调用IParsable接口的解析方法。

官方文档提到的IParsable支持，主要针对值类型（如自定义结构体）或直接作为请求参数的简单类型，而非嵌套在复杂对象中的引用类型属性。当JSON请求体中Bar字段是字符串值时，System.Text.Json会尝试将其反序列化为Bar类的实例——它默认期望Bar对应的JSON是包含Value属性的对象（如{"Value": "hello!"}），而非直接的字符串，因此会抛出转换错误。

有两种简单方式可以解决问题，不需要编写完整的自定义模型绑定器：

方案1：给Bar类添加JsonConverter特性，指定字符串解析逻辑 #

利用System.Text.Json.Serialization.JsonConverter结合已实现的IParsable逻辑创建转换器，标记在Bar类上即可：

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

[JsonConverter(typeof(BarJsonConverter))]
class Bar : IParsable<Bar>
{
    public string Value { get; set; }

    public static bool TryParse(string s, IFormatProvider? provider, out Bar result)
    {
        result = new Bar { Value = s };
        return true;
    }

    public static Bar Parse(string s, IFormatProvider? provider) => new Bar { Value = s };
}

public class BarJsonConverter : JsonConverter<Bar>
{
    public override Bar Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options)
    {
        var strValue = reader.GetString();
        return Bar.Parse(strValue, null);
    }

    public override void Write(Utf8JsonWriter writer, Bar value, JsonSerializerOptions options)
    {
        writer.WriteStringValue(value.Value);
    }
}

配置后，System.Text.Json会自动将JSON中的字符串值通过转换器映射为Bar实例，序列化时也会把Bar转换成字符串输出。

方案2：修改JSON请求体结构（若允许调整） #

如果可以更改请求格式，将Bar字段调整为符合默认反序列化逻辑的对象结构：

{
    "Bar": {
        "Value": "hello!"
    }
}

这种情况下无需额外配置，System.Text.Json就能自动将JSON对象反序列化为Bar实例，无需依赖IParsable接口。

IParsable接口在ASP.NET Core中的默认支持场景：

• 直接作为Action方法的参数（如public ActionResult Test(Bar bar)），此时框架会尝试用IParsable解析请求中的表单值、路由值或查询字符串参数。
• 作为值类型（struct）的属性，部分场景下会触发IParsable解析，但引用类型的嵌套属性默认不会触发。

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