Swagger无法识别PROPFIND方法报错，Postman可正常调用如何修复？

这个问题的根源其实是Swagger（基于OpenAPI规范）默认只支持标准HTTP方法（比如GET、POST、PUT、DELETE这类），而PROPFIND是WebDAV协议定义的扩展HTTP方法，不在Swagger的默认支持清单里，所以生成文档时才会抛出KeyNotFoundException。

下面是两种可行的修复方案，优先推荐第一种：

方案1：添加自定义Swagger操作过滤器（推荐） #

我们可以写一个操作过滤器，手动把PROPFIND方法注册到Swagger的识别列表中：

1. 先定义一个实现IOperationFilter的类：

using Microsoft.OpenApi.Models;
using Swashbuckle.AspNetCore.SwaggerGen;
using System.Linq;

public class PropfindOperationFilter : IOperationFilter
{
    public void Apply(OpenApiOperation operation, OperationFilterContext context)
    {
        // 检查当前接口方法是否标记了PROPFIND动词
        var propfindAttribute = context.MethodInfo.GetCustomAttributes(true)
            .OfType<AcceptVerbsAttribute>()
            .FirstOrDefault(a => a.Verbs.Contains("PROPFIND"));

        if (propfindAttribute != null)
        {
            // 把当前操作的HTTP方法设置为PROPFIND
            operation.Method = "PROPFIND";
            // PROPFIND一般不需要请求体，这里可以根据你的实际需求调整是否保留
            operation.RequestBody = null;
        }
    }
}

2. 在Swagger的配置代码里注册这个过滤器（.NET 6+在Program.cs，旧版本在Startup.cs的ConfigureServices中）：

builder.Services.AddSwaggerGen(options =>
{
    options.SwaggerDoc("v1", new OpenApiInfo { Title = "你的API名称", Version = "v1" });
    // 添加我们自定义的过滤器
    options.OperationFilter<PropfindOperationFilter>();
});

方案2：直接扩展Swagger的默认支持方法列表 #

这种方式更直接，但依赖Swashbuckle的内部实现，未来版本可能有变动，所以作为备选：

在Swagger配置中，通过反射获取内部的支持方法集合，手动添加PROPFIND：

builder.Services.AddSwaggerGen(options =>
{
    options.SwaggerDoc("v1", new OpenApiInfo { Title = "你的API名称", Version = "v1" });

    // 反射获取Swagger内部的SupportedMethods字典
    var supportedMethodsField = typeof(SwaggerGeneratorOptions).GetField("_supportedMethods", 
        System.Reflection.BindingFlags.NonPublic | System.Reflection.BindingFlags.Instance);
    if (supportedMethodsField != null)
    {
        var supportedMethods = (System.Collections.Generic.HashSet<string>)supportedMethodsField.GetValue(options);
        // 将PROPFIND加入支持列表
        supportedMethods.Add("PROPFIND");
    }
});

验证修复 #

完成配置后重启API项目：

• Swagger UI应该能正常加载，不会再抛出异常
• 你定义的Propfind方法会在Swagger文档中显示为PROPFIND类型的接口
• 可以在Swagger UI中尝试调用该接口（注意PROPFIND通常需要特定请求头，可能需要手动添加）

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