ASP.NET Core ApiController返回Nullable值：Swagger与NSwag配置方案

一、后端Swagger配置：生成"nullable":true Schema #

要让Swagger为可空返回值生成"nullable":true属性，需完成以下两步配置：

1. 启用项目的Nullable引用类型
   在后端项目的.csproj文件中添加<Nullable>enable</Nullable>，让编译器和Swagger能正确识别可空类型：

<Project Sdk="Microsoft.NET.Sdk.Web">
  <PropertyGroup>
    <TargetFramework>net6.0</TargetFramework>
    <Nullable>enable</Nullable>
    <ImplicitUsings>enable</ImplicitUsings>
  </PropertyGroup>
  <!-- 其他原有配置 -->
</Project>

2. 配置Swagger生成器支持可空类型
   在Program.cs的AddSwaggerGen方法中，显式配置支持可空类型的Schema生成：

builder.Services.AddSwaggerGen(options =>
{
    // 禁用非空引用类型强制模式，允许Swagger为可空类型生成nullable:true标记
    options.SupportNonNullableReferenceTypes(false);
});

完成后重新生成OpenAPI文档（BackendService.json），就能看到DateTime?返回值对应的Schema已包含"nullable":true属性。

二、NSwagCSharp客户端配置：生成可空类型处理代码 #

修改客户端项目.csproj中的OpenApiReference选项，添加可空引用类型生成参数，确保客户端代码能正确处理null返回值：

<OpenApiReference Include="..\Backend\BackendService.json" CodeGenerator="NSwagCSharp" Link="OpenAPIs\BackendService.json">
   <Options>/GenerateClientInterfaces:true /AdditionalNamespaceUsages:Base.Entities /GenerateDtoTypes:false /NullableReferenceTypes:true</Options>
</OpenApiReference>

关键新增参数/NullableReferenceTypes:true会让NSwag根据OpenAPI中的nullable:true标记，生成对应可空类型（比如DateTime?而非DateTime），确保客户端能正确接收null结果。

验证步骤 #

1. 重新构建后端项目，生成最新的OpenAPI文档
2. 重新构建客户端项目，检查生成的客户端接口方法，确认返回类型为DateTime?
3. 测试接口返回null的场景，验证客户端能正常处理

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