ASP.NET Core错误处理无HTTP动词触发Swashbuckle异常原因问询

官方给出该建议的底层逻辑主要有两点：

• 错误触发场景的HTTP方法不确定性：触发错误处理逻辑的上游请求可能是任意HTTP方法，包括GET、POST、PUT、DELETE、PATCH、HEAD、OPTIONS等。如果为错误处理Action标注了特定HTTP方法特性（如[HttpGet]），那么使用非匹配方法发起的请求触发异常时，会直接返回405 Method Not Allowed响应，无法进入自定义错误处理逻辑，导致错误页、自定义错误响应都无法正常返回，完全失去错误处理的作用。
• 异常中间件的转发规则：ASP.NET Core内置的异常处理中间件（UseExceptionHandler）、状态码页中间件（UseStatusCodePagesWithReExecute）转发请求到/error端点时，默认会保留原始请求的HTTP方法，不会统一修改为GET。如果错误Action限制了HTTP方法，转发后的请求就会因方法不匹配被路由拦截。

Swagger冲突的解决方案 #

你不需要违背官方建议给错误Action加单一HTTP方法特性，可通过以下两种方案解决冲突：

• 给Error方法添加[ApiExplorerSettings(IgnoreApi = true)]特性，直接让Swagger生成逻辑忽略该端点，错误处理端点本身不需要对外暴露到接口文档中，是最推荐的方案。
• 如果确实需要将错误端点纳入接口文档，可添加[AcceptVerbs("GET", "POST", "PUT", "DELETE", "PATCH", "HEAD", "OPTIONS")]特性，显式声明支持所有HTTP方法，同时满足Swagger的方法明确性要求和错误处理的全方法适配要求。

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