ASP.NET Core Web API传入空字符串status返回400错误求助

我有一个ASP.NET Core Web API的POST接口，接收JSON格式请求，请求头已设置Content-Type: application/json。当传入status值为NEW或QUEUE时，接口返回200 Success；但传入空字符串时，返回400 Bad Request错误。

报错请求示例 #

{
    "orderId": 0,
    "customerId": 999999,
    "orderNumber": "12345",
    "orderTypeId": 5,
    "status": ""
}

正常请求示例 #

示例1 #

{
    "orderId": 0,
    "customerId": 999999,
    "orderNumber": "12345",
    "orderTypeId": 5,
    "status": "NEW"
}

示例2 #

{
    "orderId": 0,
    "customerId": 999999,
    "orderNumber": "12345",
    "orderTypeId": 5,
    "status": "QUEUE"
}

实体类定义 #

我的Orders实体类中Status字段未添加空值限制验证，且默认初始化为空字符串，按预期传入空字符串应该返回200 Success：

namespace Sample.DT
{
    using System.ComponentModel.DataAnnotations;
    using System.ComponentModel.DataAnnotations.Schema;
    using System.Net;

    public class Orders
    {
        public int OrderId { get; set; }

        public int CustomerId { get; set; }

        [Required(ErrorMessage = "Order number is required")]
        [StringLength(15, ErrorMessage = "Please enter valid order number")]
        public string OrderNumber { get; set; }

        [Required]
        public int OrderTypeId { get; set; }

        public string Status { get; set; } = "";
    }
}

问题排查及解决办法 #

1. 检查控制器Action自定义逻辑
   先确认接口的Action方法中是否存在手动判断Status为空的代码，比如：

   [HttpPost]
   public IActionResult Post(Orders order)
   {
       if (string.IsNullOrEmpty(order.Status))
       {
           return BadRequest();
       }
       // 其他业务逻辑
   }
   

   如果有这类代码，直接移除或修改逻辑即可让空字符串返回200。

2. 全局验证配置检查
   查看Program.cs（或旧版本Startup.cs）中是否配置了全局强制验证规则，比如强制要求字符串非空。例如是否有类似以下配置：

   builder.Services.AddControllers()
       .AddJsonOptions(options =>
       {
           // 可能存在的空字符串限制配置
       });
   

   或者是否启用了第三方验证框架的全局规则，找到后调整为允许空字符串。

3. 调整模型验证特性
   给Status字段添加明确允许空值的特性，避免默认验证触发400：

   [AllowNull]
   public string Status { get; set; } = "";
   

   或者使用StringLength指定最小长度为0：

   [StringLength(int.MaxValue, MinimumLength = 0)]
   public string Status { get; set; } = "";
   

4. 禁用自动400响应
   如果是[ApiController]特性自动触发的400响应，可以全局禁用该功能，手动处理模型验证结果：

   // Program.cs中添加配置
   builder.Services.Configure<ApiBehaviorOptions>(options =>
   {
       options.SuppressModelStateInvalidFilter = true;
   });
   

   然后在Action中手动控制响应：

   [HttpPost]
   public IActionResult Post(Orders order)
   {
       if (!ModelState.IsValid)
       {
           // 自定义处理，比如返回200
           return Ok();
       }
       // 业务逻辑
       return Ok();
   }
   

内容的提问来源于stack exchange，提问作者Deals Must Buy