在开发一个基于 ASP.NET Core 10.0 的 Web API 项目时，遇到了一个令人困惑的验证错误。

库存扣减接口的原始代码如下：

[HttpPost("{drugId}/decrement/{quantity}")]
public async Task<string?> DecInventoryAsync(
    [FromRoute] string drugId,
    [FromRoute] int quantity)
{
    var inventory = await _inventoryService.DeductInventoryAsync(drugId, quantity);
    return inventory;
}


POST /api/inventories/drug001/decrement/10


{
    "errors": {
        "quantity": ["Required field is not provided."]
    }
}


既然路由拼写和参数绑定看起来都没问题，那就一步步缩小范围。

[HttpPost("{drugId}/decrement/{quantity}")]
public async Task<string?> DecInventoryAsync(string drugId, int quantity)


public async Task<string?> DecInventoryAsync(
    [FromRoute] string drugId,
    [FromRoute] int? quantity)


绑定场景下，验证管道无法正确识别该参数已被路由提供，于是报了误判错误。

四者叠加，触发了验证管道的兼容性边界 bug。

确定了根因，接下来评估修复方案。核心思路是

// Models/Dto/InventoryDecrementDto.cs
using System.ComponentModel.DataAnnotations;

namespace MyWebApp.Models.Dto;

public class InventoryDecrementDto
{
    [Required(ErrorMessage = "药品ID不能为空")]
    public string DrugId { get; set; }

    [Required(ErrorMessage = "库存数量不能为空")]
    [Range(1, int.MaxValue, ErrorMessage = "库存数量必须大于0")]
    public int Quantity { get; set; }
}


// 修改前
[HttpPost("{drugId}/decrement/{quantity}")]
public async Task<string?> DecInventoryAsync(
    [FromRoute] string drugId,
    [FromRoute] int quantity)

// 修改后
[HttpPost("decrement")]
public async Task<string?> DecInventoryAsync(InventoryDecrementDto decrementDto)
{
    var inventory = await _inventoryService.DeductInventoryAsync(
        decrementDto.DrugId,
        decrementDto.Quantity);
    return inventory;
}


POST /api/inventories/decrement
Content-Type: application/json

{
    "drugId": "drug001",
    "quantity": 10
}


[ApiController] 自动验证
       +
非可空值类型 int → 隐式添加 [Required]
       +
多个 [FromRoute] 参数
       +
.NET 原生 AddOpenApi() 的 schema 生成逻辑
       ↓
验证管道无法正确识别路由参数的绑定来源
       ↓
"Required field is not provided."（误报）


参数时，生成的 OpenAPI schema 与验证管道的判断逻辑不一致，导致验证管道认为

排坑日记：ASP.NET Core 中 "Required field is not provided" 验证错误全记录

Required field is not provided in asp.net core

后端

编程语言

开发工具

ASP.NET Core WebAPI开发中遇到库存扣减接口400错误，问题源于[ApiController]对非可空int类型自动添加[Required]验证，与多[FromRoute]参数绑定冲突。解决方案推荐改用DTO请求体模式，既符合RESTful规范，又能避免验证管道误判，提供更友好的错误提示。

路由

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

排坑日记：ASP.NET Core 中 "Required field is not provided" 验证错误全记录

排坑日记：ASP.NET Core 中 "Required field is not provided" 验证错误全记录

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐