如何在SOAPCore中为用户错误场景替换500状态码为400？

针对你遇到的SOAPCore始终返回500状态码的问题，有以下两种可行方案：

方案一：自定义异常过滤器（推荐） #

通过实现ExceptionFilterAttribute，拦截用户异常并手动设置HTTP状态码，同时生成自定义SOAP Fault：

1. 定义自定义用户异常
   用来标记属于用户输入错误的异常：

public class UserInputException : Exception
{
    public UserInputException(string message) : base(message) { }
    public UserInputException(string message, Exception innerException) : base(message, innerException) { }
}

2. 实现异常过滤器
   继承ExceptionFilterAttribute，在异常处理逻辑中设置状态码并构建SOAP Fault：

using Microsoft.AspNetCore.Mvc;
using Microsoft.AspNetCore.Mvc.Filters;
using System.ServiceModel;
using System.ServiceModel.Channels;

public class SoapExceptionFilter : ExceptionFilterAttribute
{
    public override void OnException(ExceptionContext context)
    {
        if (context.Exception is UserInputException userEx)
        {
            // 设置HTTP 400状态码
            context.HttpContext.Response.StatusCode = StatusCodes.Status400BadRequest;

            // 构建符合SOAP规范的Fault
            var faultCode = FaultCode.CreateSenderFaultCode("InvalidUserInput", "http://your-service-namespace/errors");
            var faultReason = new FaultReason(userEx.Message);
            var messageFault = MessageFault.CreateFault(faultCode, faultReason);

            // 替换异常结果为自定义SOAP Fault
            context.Result = new SoapFaultResult(messageFault);
            context.ExceptionHandled = true; // 标记异常已处理，避免默认逻辑覆盖
        }
        else
        {
            // 非用户异常仍返回500
            context.HttpContext.Response.StatusCode = StatusCodes.Status500InternalServerError;
            base.OnException(context);
        }
    }
}

3. 注册过滤器
   在Startup.cs或Program.cs中将过滤器添加到服务配置：

// .NET 6+ Program.cs
builder.Services.AddControllers(options =>
{
    options.Filters.Add<SoapExceptionFilter>();
});

// 同时确保SOAP服务正常注册
builder.Services.AddSoapCore();
builder.Services.AddSingleton<YourSoapServiceImplementation>();

4. 业务代码中抛出用户异常
   当检测到用户输入错误时，抛出UserInputException：

public string YourSoapMethod(string input)
{
    if (string.IsNullOrEmpty(input))
    {
        throw new UserInputException("输入参数不能为空");
    }
    // 正常业务逻辑
    return "处理结果";
}

方案二：使用中间件拦截响应 #

如果过滤器无法满足需求，可以通过中间件在响应发送前修改状态码：

public class SoapStatusCodeMiddleware
{
    private readonly RequestDelegate _next;

    public SoapStatusCodeMiddleware(RequestDelegate next)
    {
        _next = next;
    }

    public async Task InvokeAsync(HttpContext context)
    {
        // 先执行后续中间件
        await _next(context);

        // 仅处理SOAP请求的响应
        if (context.Request.Path.StartsWithSegments("/your-soap-endpoint") 
            && context.Response.StatusCode == StatusCodes.Status500InternalServerError)
        {
            // 读取响应内容，判断是否为用户错误类型的Fault
            // 注意：这里需要解析SOAP响应的Fault内容，根据实际Fault代码判断是否改为400
            var originalBody = context.Response.Body;
            using var newBody = new MemoryStream();
            context.Response.Body = newBody;
            newBody.Seek(0, SeekOrigin.Begin);
            var soapContent = await new StreamReader(newBody).ReadToEndAsync();
            
            if (soapContent.Contains("InvalidUserInput"))
            {
                context.Response.StatusCode = StatusCodes.Status400BadRequest;
            }

            // 将内容写回原响应流
            newBody.Seek(0, SeekOrigin.Begin);
            await newBody.CopyToAsync(originalBody);
            context.Response.Body = originalBody;
        }
    }
}

注册中间件（注意要放在SOAP服务注册之前）：

// Program.cs
app.UseMiddleware<SoapStatusCodeMiddleware>();
app.UseSoapEndpoint<YourSoapServiceImplementation>("/your-soap-endpoint", new SoapEncoderOptions());

注意：中间件方案需要解析SOAP响应内容，相对复杂，仅在过滤器方案无法生效时考虑使用。

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