使用Newtonsoft.Json导致Swagger展示的属性名称错误

使用Newtonsoft.Json导致Swagger展示的属性名称错误

1.问题

我在代码中写了取消驼峰命名法的代码，但是在Swagger中，发现展示的数据竟然还是小写开头，但是返回的数据却没有问题。

1.1.举例

下方为接口传入实体

public class UserDto{
    public string UserName {get;set;}
    public string UserCode {get;set;}
}

我明确设置了取消使用驼峰命名法序列化实体

service.AddNewtonsoftJson(options =>
{
	options.SerializerSettings.ContractResolver = null;
});

但是swagger页面中的展示的Json竟然还是按照驼峰命名法输出的

{
    "userName":"",
    "UserCode":""
}

2.解决方案

需要安装额外的包

Install-Package Swashbuckle.AspNetCore.Newtonsoft

3.为什么会出现这个问题

微软在发布DotNet 3.0以后,推出了关于Json序列化的类库:

System.Text.Json

正是因为这个类库的加入,Swagger们开始转向使用原生支持,如果你使用了Newtonsoft.Json来作为序列化的工具,就需要安装上方解决方案中的类库。

3.1.线索出自

https://github.com/domaindrivendev/Swashbuckle.AspNetCore