C# ASP.NET Core如何设置Swagger在Create/POST方法中忽略id属性

完全可以实现，根据项目技术栈选择对应方案即可：

方案1：使用专用请求DTO（推荐） #

最规范的做法是不要直接将数据库实体作为接口入参，单独定义新增操作专用的传输对象，仅保留前端需要传入的字段：

public class CreateProductReq
{
    public string Name { get; set; }
    public int Quantity { get; set; }
    public int TypeId { get; set; }
    public int BrandId { get; set; }
}

POST接口入参替换为这个类型后，Swagger会自动按类结构生成请求Schema，不会出现id字段，同时也能避免数据库结构直接对外暴露。

方案2：给主键字段加只读标记 #

如果不想额外创建DTO，直接用数据库实体作为入参，可以通过注解标记id为只读字段，让Swagger识别该字段不需要前端传入：

• .NET + Swashbuckle场景：在Id属性上添加[SwaggerSchema(ReadOnly = true)]，标记后字段只会出现在接口返回结构中，不会出现在POST请求的参数和示例里，不影响接口正常返回id值。

  using Swashbuckle.AspNetCore.Annotations;
  
  public class Product
  {
      [SwaggerSchema(ReadOnly = true)]
      public int Id { get; set; }
      public string Name { get; set; }
      public int Quantity { get; set; }
      public int TypeId { get; set; }
      public int BrandId { get; set; }
  }
  

  如果项目使用Newtonsoft.Json做序列化，给Id字段加[JsonProperty(ReadOnly = true)]也能达到同样效果。
• Java + SpringDoc/SpringFox场景：在实体类的id字段上添加@Schema(accessMode = AccessMode.READ_ONLY)注解即可。

方案3：全局自动过滤自增主键 #

如果项目中存在大量带自增主键的实体，不想逐个加注解，可以自定义Swagger过滤器，全局扫描入参类型中标记了数据库自增特性的字段，自动将其从请求Schema中移除。
以.NET栈为例，通常自增主键都会标记[DatabaseGenerated(DatabaseGeneratedOption.Identity)]特性，过滤器可以统一识别这类特性做处理，一次配置全局生效，不需要修改实体代码。

配置完成后重启服务刷新Swagger页面，POST接口的请求示例就会移除id字段，不再要求前端传入该参数，和SQL Server自增主键的逻辑完全匹配。

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