C#怎么实现REPR端点模式_C# FastEndpoints最小API教程【进阶】-C#.Net教程-PHP中文网

REPR 是 FastEndpoints 社区归纳的 Request→Endpoint→Response 端点组织模式，Endpoint 是其落地载体，需显式定义 TRequest/TResponse 类型；SendAsync 返回具名响应类以保障 Swagger 和测试，Configure 中路径/动词错误导致 404，Pre/PostProcessor 有固定执行时机，DTO 验证应依赖 FluentValidation 自动处理。

c#怎么实现repr端点模式_c# fastendpoints最小api教程【进阶】

REPR 不是框架内置的抽象接口，也不是 C# 语言特性——它是 FastEndpoints 社区对端点组织逻辑的一种模式归纳：Request → Endpoint → Response。它不强制你写三类文件，但一旦你按这个结构组织代码，路由、验证、序列化、日志、测试就自然解耦。直接上手就行，别被名字唬住。

Endpoint 是 REPR 的落地载体

这是最贴近 REPR 意图的基类，它显式声明了输入和输出契约，编译期就能约束类型流，比 EndpointWithoutRequest 或裸 Endpoint 更适合 API 契约明确的场景。

常见错误现象：SendAsync(new { ... }) 返回匿名对象 → Swagger 文档缺失响应结构，前端 TypeScript 客户端生成失败，单元测试难 mock。

必须定义具名 TResponse 类（哪怕只含一个字段），否则 FastEndpoints.Swagger 无法推导 200 响应体
HandleAsync 中调用 SendAsync(new MyResponse { ... })，不是 return，不是 Ok()，也不是 Results.Ok()
若需返回不同状态码（如 400），用 SendNotFound()、SendValidationFailure() 等内置方法，它们会自动匹配对应 HTTP 状态，且保留 TResponse 类型上下文

Configure() 里写错动词或路径，会导致端点“消失”

FastEndpoints 不扫描控制器，它靠 Configure 方法里的 Get、Post、Patch 等调用注册端点。漏写、拼错、多写斜杠，API 就 404，而且没提示。

典型错误：

Post("/api/user") 和 Post("api/user") —— 后者少开头 /，注册为相对路径，实际不生效
Get("/users/{id}") 但 DTO 里没声明 public string id { get; set; } → 运行时绑定失败，返回 400，但控制台无警告
多个端点用了相同路径+动词 → 后注册的覆盖前一个，静默丢弃（无编译错误、无启动日志）

建议：在 Configure 结尾加 AllowAnonymous() 或 RequireAuthorization() 显式声明权限，避免因中间件顺序导致认证拦截被跳过。

"避开 C# 常见错误——空陷阱、异步陷阱、LINQ 陷阱及资源泄漏。"

下载

PreProcessor/PostProcessor 不是装饰器，是独立生命周期阶段

IPreProcessor 和 IPostProcessor 的执行时机固定：Pre 在模型绑定后、HandleAsync 前；Post 在 SendAsync 调用后、响应写出前。它们不能修改 HandleAsync 的返回值，也不能提前终止流程（除非抛异常）。

容易踩的坑：

在 PreProcessor 里调用 ctx.HttpContext.Response.WriteAsync() → 冲突，因为 SendAsync 会再次尝试写响应体，触发 System.InvalidOperationException: Headers are read-only
想做请求日志，但 ctx.Request 是已反序列化的对象，敏感字段（如密码）可能已被脱敏，日志内容和原始 JSON 不一致
PostProcessor 里修改 ctx.Response 属性无效 —— 此时响应体已序列化完成，只能改 Header 或 StatusCode

DTO 验证失败时，不要手动 throw ValidationException

FastEndpoints 默认集成 FluentValidation，只要你的 TRequest 类有对应 IValidator 实现，验证失败会自动返回 400 + 格式化错误详情（ValidationFailure 数组）。手动 throw 只会让全局异常中间件接管，丢失标准错误结构。

关键点：

验证器类名必须是 TRequest 名 + Validator（如 MyRequestValidator），否则不自动发现
验证器构造函数注入的服务（如 ILogger）会被正确解析，无需额外配置
若需自定义 400 响应体格式，重写端点的 OnValidationFailure 方法，而不是拦截异常

复杂点在于：当 DTO 包含嵌套对象或集合时，FluentValidation 的错误路径（PropertyName）默认是 Address.Street 这种，但前端表单常按 address.street 绑定 —— 这需要在验证器里显式调用 OverridePropertyName 或统一转小驼峰，否则错误定位不准。