本文讲解在使用Swagger进行接口调试时如果给参数设置默认值。

首先创建接口参数接收类SearchReq，代码如下：

namespace NetCoreStudy.Model
{
    public class SearchReq
    {
        public string Name { get; set; }
        public string Description { get; set; }
        public int PageIndex { get; set; }
        public int PageSize { get; set; }
    }
}

创建接口测试类，代码如下：

using Microsoft.AspNetCore.Mvc;
using NetCoreStudy.Model;

namespace NetCoreStudy.Controllers
{
    [Route("api/[controller]/[action]")]
    [ApiController]
    public class ValuesController : ControllerBase
    {
        [HttpPost]
        public string Test(SearchReq req)
        {
            return "ok"+req.Name;
        }
    }
}

运行调用接口时，string类型的参数默认都是string字符串，数值类型的参数默认值都是0，下面讲解如果给各个参数设置默认值。

首先创建DefaultValueSchemaFilter类并实现ISchemaFilter接口，代码如下：

using Microsoft.OpenApi.Any;
using Microsoft.OpenApi.Models;
using Swashbuckle.AspNetCore.SwaggerGen;

namespace NetCoreStudy.Config
{
    public class DefaultValueSchemaFilter : ISchemaFilter
    {
        public void Apply(OpenApiSchema schema, SchemaFilterContext context)
        {
            if (schema == null) { 
                return;
            }
            var objectSchema = schema;
            foreach (var property in objectSchema.Properties) {
                //设置字符串类型参数为""值
                if (property.Value.Type == "string" && property.Value.Default == null) { 
                    property.Value.Default = new OpenApiString("");
                }
                //设置pageIndex参数默认值为1
                if (property.Key == "pageIndex") {
                    property.Value.Default = new OpenApiInteger(1);
                }
                //设置pageSize参数默认值为10
                else if (property.Key == "pageSize")
                {
                    property.Value.Default = new OpenApiInteger(10);
                }
            }
        }
    }
}

然后修改Progams.cs文件，代码如下：

builder.Services.AddSwaggerGen(options => {
    //设置对象类型参数默认值
    options.SchemaFilter<DefaultValueSchemaFilter>();
});

访问测试，接口调用传递参数如下图所示：