如何在ASP.NET Core Web应用中避免创建大量相似类？

在ASP.NET Core的CRUD开发中，你遇到的DTO字段差异问题非常普遍，下面针对你的疑问给出实际可用的解决方案和补充选项：

一、推荐的通用方案：专用DTO + 对象映射工具 #

你提到的方案1（为每个端点创建单独类）其实是业界主流实践，只是可以通过AutoMapper这类工具大幅降低维护成本：

• 为每个端点创建职责单一的DTO：
  • CreateProductDto：仅包含创建时需要的属性，不含ID
  • UpdateProductDto：包含ID和允许更新的属性（可根据需求设为可空）
  • ProductDto：包含ID和所有需要返回给前端的属性
• 用AutoMapper配置映射规则，自动完成DTO与实体类之间的转换，无需手动写赋值代码：

  // 示例映射配置
  public class MappingProfile : Profile
  {
      public MappingProfile()
      {
          // 创建DTO转实体
          CreateMap<CreateProductDto, Product>();
          // 更新DTO转实体，仅更新非空字段
          CreateMap<UpdateProductDto, Product>()
              .ForAllMembers(opt => opt.Condition((src, dest, val) => val != null));
          // 实体转返回DTO
          CreateMap<Product, ProductDto>();
      }
  }
  

这种方式的优势是：

• Swagger文档精准，不会出现多余字段
• 代码职责清晰，避免误用字段（比如创建时错误传入ID）
• 映射工具帮你处理重复的赋值逻辑，维护成本远低于想象

二、你未考虑的补充方案 #

1. 利用属性标记控制序列化与绑定 #

如果不想创建过多类，可以在通用类中通过属性标记控制字段的可见性：

• 给ID添加[SwaggerSchema(ReadOnly = true)]，Swagger会标注该字段为只读，前端不会在创建/更新表单中看到它
• 用[BindNever]确保创建端点不会绑定ID属性，即使前端传了也会被忽略
• 用[JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingDefault)]，让ID在未赋值时（比如创建场景）不被序列化返回
  这种方式适合简单场景，但代码层面仍存在冗余字段，容易出现逻辑漏洞。

2. 使用记录类型（Record）简化DTO定义 #

C# 9+的Record类型语法简洁，适合定义DTO，减少代码冗余：

// 创建DTO
public record CreateProductDto(string Name, decimal Price);
// 返回DTO
public record ProductDto(int Id, string Name, decimal Price);
// 更新DTO
public record UpdateProductDto(int Id, string? Name, decimal? Price);

Record是值类型，自带相等性判断，配合AutoMapper使用，代码会非常简洁。

3. 结合MediatR的请求/响应模型 #

如果项目使用CQRS模式，用MediatR将每个CRUD操作封装为独立的请求类，每个请求对应专属的DTO：

• CreateProductCommand：包含创建所需的属性
• UpdateProductCommand：包含ID和更新属性
• GetProductQuery：返回ProductDto
  这种方式进一步拆分职责，大型项目中结构更清晰，类的数量虽然多，但组织有序，维护成本可控。

三、方案对比总结 #

没有适用于所有场景的银弹，但专用DTO+AutoMapper是最平衡的选择：

• 比方案2（可空类）更安全，不会出现字段误用
• 比方案3（拆分属性）更符合REST规范，返回结构更完整
• 比方案4（继承）更清晰，不会出现冗长的类名

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