ASP.NET Core Web API接收SOAP请求时HttpRequestMessage为null问题

我来帮你排查这个问题，这其实是ASP.NET Core和传统ASP.NET Web API在请求处理逻辑上的差异，再加上SOAP格式的特殊要求导致的，咱们一步步来解决：

为什么会出现HttpRequestMessage为null？ #

在传统的ASP.NET Web API中，HttpRequestMessage是默认的请求绑定类型，但ASP.NET Core已经重构了请求处理管道，默认不会自动将请求内容绑定到HttpRequestMessage参数上，这就是你看到它为null的核心原因。而且SOAP格式的XML需要特殊的序列化配置才能被正确解析。

推荐解决方案：直接绑定到DTO模型 #

这种方式最符合ASP.NET Core的设计理念，也最简洁易维护：

1. 定义匹配SOAP结构的DTO类 #

要注意和SOAP XML里的命名空间、节点名称完全对应：

[XmlRoot("DTO", Namespace = "http://tempuri.org/")]
public class MyDto
{
    public int field1 { get; set; }
    public int field2 { get; set; }
}

2. 修改API接口方法 #

替换HttpRequestMessage为你的DTO，并加上[FromBody]特性触发请求体绑定：

[HttpPost]
public IActionResult Foo([FromBody] MyDto data)
{
    // 这里就能正常获取到field1和field2的值了
    if (data == null)
    {
        return BadRequest("请求数据格式不正确");
    }
    // 处理你的业务逻辑
    return Ok($"收到数据：field1={data.field1}, field2={data.field2}");
}

3. 配置ASP.NET Core的XML格式化器 #

ASP.NET Core默认优先支持JSON，所以需要手动添加XML序列化支持。在.NET 6+的Program.cs里配置：

builder.Services.AddControllers()
    // 添加XmlSerializer格式化器（对应我们用的XmlRoot特性）
    .AddXmlSerializerFormatters()
    // 可选：添加DataContractSerializer格式化器（如果你的DTO用DataContract特性标注）
    .AddXmlDataContractSerializerFormatters();

备选方案：手动读取并解析SOAP请求体 #

如果你坚持要处理原始的SOAP XML（不推荐，因为繁琐且易出错），可以直接读取请求流自行解析：

[HttpPost]
public async Task<IActionResult> Foo()
{
    // 读取原始请求体内容
    using var streamReader = new StreamReader(Request.Body);
    var soapXmlContent = await streamReader.ReadToEndAsync();

    // 解析SOAP XML，提取DTO部分
    var soapDoc = XDocument.Parse(soapXmlContent);
    // 定义SOAP和DTO的命名空间
    XNamespace soapNs = "http://schemas.xmlsoap.org/soap/envelope/";
    XNamespace dtoNs = "http://tempuri.org/";

    // 定位到DTO节点
    var dtoNode = soapDoc.Descendants(soapNs + "Body")
                         .Elements(dtoNs + "DTO")
                         .FirstOrDefault();

    if (dtoNode == null)
    {
        return BadRequest("未找到有效的DTO数据");
    }

    // 提取字段值
    int field1 = int.Parse(dtoNode.Element(dtoNs + "field1").Value);
    int field2 = int.Parse(dtoNode.Element(dtoNs + "field2").Value);

    // 处理业务逻辑
    return Ok($"手动解析到数据：field1={field1}, field2={field2}");
}

Postman发送请求的关键注意事项 #

不管用哪种方案，都要确保Postman的请求配置正确：

• 请求方法选择POST
• 请求头添加Content-Type，值为application/soap+xml; charset=utf-8（SOAP 1.2规范），如果是SOAP 1.1则用text/xml; charset=utf-8
• 请求体选择raw -> 格式选XML，粘贴你的SOAP XML内容

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