如何在Swagger中为IEnumerable类型属性设置多个默认值？

你当前的单默认值写法是可行的：

[DefaultValue(CardStatus.Production)]
public IEnumerable<CardStatus>? CardStatuses { get; set; }

但直接用[DefaultValue([CardStatus.Production, CardStatus.Pending])]这种写法无效，因为C#不允许在特性参数中直接使用数组初始化语法。下面提供两种可行的实现方式：

方法1：使用Swagger自定义特性与过滤器 #

如果你使用Swashbuckle.AspNetCore，可以通过自定义IOperationFilter手动为参数设置多默认值：

1. 给属性添加自定义标记（也可直接通过参数名匹配，此步骤可选）：

public class MultipleDefaultValuesAttribute : Attribute
{
    public object[] Values { get; }
    public MultipleDefaultValuesAttribute(params object[] values)
    {
        Values = values;
    }
}

// 在模型中标记属性
[MultipleDefaultValues(CardStatus.Production, CardStatus.Pending)]
public IEnumerable<CardStatus>? CardStatuses { get; set; }

2. 实现操作过滤器：

public class MultipleDefaultValuesFilter : IOperationFilter
{
    public void Apply(OpenApiOperation operation, OperationFilterContext context)
    {
        foreach (var parameter in operation.Parameters)
        {
            // 匹配对应模型属性
            var property = context.ApiDescription.ActionDescriptor.Parameters
                .Select(p => p.ParameterType.GetProperty(parameter.Name))
                .FirstOrDefault(p => p != null);

            if (property == null) continue;

            var attr = property.GetCustomAttribute<MultipleDefaultValuesAttribute>();
            if (attr != null)
            {
                // 设置默认值与示例值，适配Swagger UI显示
                var defaultValueArray = new OpenApiArray(
                    attr.Values.Select(v => new OpenApiString(v.ToString())).ToList()
                );
                parameter.Schema.Default = defaultValueArray;
                parameter.Schema.Example = defaultValueArray;
            }
        }
    }
}

3. 在Startup/Program中注册过滤器：

builder.Services.AddSwaggerGen(c =>
{
    c.OperationFilter<MultipleDefaultValuesFilter>();
});

方法2：直接在模型初始化时设置默认值 #

如果API逻辑允许，可直接在模型构造函数中初始化默认值，Swagger通常会识别该默认值：

public class YourRequestModel
{
    public IEnumerable<CardStatus>? CardStatuses { get; set; }

    public YourRequestModel()
    {
        CardStatuses = new List<CardStatus> { CardStatus.Production, CardStatus.Pending };
    }
}

这种方式更简洁，但要注意：前端未传值时，后端会直接使用该默认值，而非仅在Swagger UI中显示。

注意事项 #

• 不同版本的Swashbuckle.AspNetCore在OpenAPI对象结构上可能有细微差异，需根据使用版本调整过滤器代码。
• 枚举类型需确保Swagger正确识别其字符串或数值形式，避免序列化异常。

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