.NET 6中如何配置HTTP POST的Wrapped Request？WCF迁移参数绑定问题

问题原因 #

WCF的WebMessageBodyStyle.WrappedRequest会自动将单个参数包裹在JSON对象中（如{"idContract":"245"}），但.NET 6的ASP.NET Core默认模型绑定不会自动解析这种格式的单参数，导致参数始终为默认值（int类型就是0）。

解决方案 #

方案1：创建DTO类包裹参数（推荐）

定义一个与请求体结构匹配的DTO类，通过[FromBody]标记让框架自动解析：

// 定义请求DTO
public class GetContractRequest
{
    public int idContract { get; set; }
}

// 控制器方法修改
[HttpPost]
[Route("GetContract")]
public ContractResult GetContract([FromBody] GetContractRequest request)
{
    // 使用request.idContract获取参数值
    return GetContractById(request.idContract);
}

方案2：直接解析JSON请求体（无需创建DTO）

如果不想额外定义DTO，可以使用JObject接收请求体，手动提取参数：

using Newtonsoft.Json.Linq; // 需要安装Newtonsoft.Json包

[HttpPost]
[Route("GetContract")]
public ContractResult GetContract([FromBody] JObject body)
{
    int idContract = body.Value<int>("idContract");
    return GetContractById(idContract);
}

方案3：全局配置自动支持包裹式单参数（批量兼容）

如果有大量类似的方法需要兼容，可以自定义InputFormatter来全局处理这种格式：

1. 实现自定义InputFormatter：

public class WrappedSingleParameterInputFormatter : SystemTextJsonInputFormatter
{
    public WrappedSingleParameterInputFormatter(JsonOptions options) : base(options)
    {
        SupportedMediaTypes.Add(MediaTypeHeaderValue.Parse("application/json"));
    }

    public override async Task<InputFormatterResult> ReadRequestBodyAsync(InputFormatterContext context)
    {
        var type = context.ModelType;
        if (!type.IsValueType && type != typeof(string))
        {
            return await base.ReadRequestBodyAsync(context);
        }

        using var reader = new StreamReader(context.HttpContext.Request.Body);
        var json = await reader.ReadToEndAsync();
        var jObject = JObject.Parse(json);
        var property = jObject.Properties().FirstOrDefault();
        
        if (property != null)
        {
            var value = property.Value.ToObject(type);
            return await InputFormatterResult.SuccessAsync(value);
        }

        return await InputFormatterResult.FailureAsync();
    }
}

2. 在Program.cs中注册这个InputFormatter：

builder.Services.AddControllers(options =>
{
    options.InputFormatters.Insert(0, new WrappedSingleParameterInputFormatter(new JsonOptions()));
});

这样修改后，原控制器方法无需改动，就能直接从请求体的包裹JSON中绑定参数：

[HttpPost]
[Route("GetContract")]
public ContractResult GetContract(int idContract)
{
    return GetContractById(idContract);
}

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