.NET中Swashbuckle CLI与NSwag可空引用类型配置问题

确保你的ASP.NET 5.0 Web API项目已在csproj文件中开启全局可空引用类型配置：

<PropertyGroup>
  <TargetFramework>net5.0</TargetFramework>
  <Nullable>enable</Nullable>
</PropertyGroup>

你当前使用的--serializeasv2参数强制输出OpenAPI 2.0规范，该规范不支持单字段级别的nullable细粒度配置，才会出现全字段强制可空的问题；默认OpenAPI 3.0模式下Swashbuckle未开启可空引用类型的自动识别，所以未标记Required的引用类型不会自动加nullable: true标识。

• 移除CLI命令中的--serializeasv2参数，切换回OpenAPI 3.0规范输出
• 在Web API项目的Startup.cs服务注册逻辑中，调整Swagger生成配置：

services.AddSwaggerGen(c =>
{
    // 启用可空引用类型识别，自动给未标记Required的引用类型加nullable: true
    c.SupportNullableReferenceTypes();
    // 启用Swagger注解支持，识别[Required]标记
    c.EnableAnnotations();
});

• 调整后的dotnet swagger CLI命令如下：

dotnet swagger tofile --output $(MSBuildProjectDirectory)\nswag\swagger.json project.dll v1 ConsoleToMSBuild="true" WorkingDirectory="$(OutputPath)"

• 配置NSwag C#客户端生成规则，开启可空引用类型生成：
  若使用nswag.json配置，设置"generateNullableReferenceTypes": true；
  若使用NSwag CLI命令，添加参数/generateNullableReferenceTypes:true。

生成的swagger.json中，未标记[Required]的引用类型会自动携带"nullable": true属性，标记了[Required]的引用类型不会出现该属性，NSwag生成客户端时会严格遵循该规则输出对应可空/非可空的引用类型，和基础类型的可空规则保持一致。

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