.NET 6添加[ProducesResponseType]注解后Swagger加载失败

在.NET 6项目里用Swashbuckle NuGet包生成Swagger文档，给POST方法加[ProducesResponseType]注解后，Swagger就加载不了API定义；删掉这个注解就恢复正常，其他方法的XML注释都能正常生效。相关代码片段如下：

/// <summary>
/// 提交增值税记录（个体）
/// </summary>
/// <remarks>
/// 请求示例
/// 
///     POST
///     {
///      "documentNumber": "300720221231",
///      "calculationNumber":2424524588001,
///      "relatedPartyIdentifier":"test555",
///      "documentType": "Invoice",
///      "foreignDocument":false,
///      "vatAmount": 110,
///      "year": 2022
///     }
/// </remarks>
/// <response code="200">API密钥已成功保存到数据库</response>
[ProducesResponseType(typeof(Result<VatRecordingIndividualResponseDto>), 200)]
[Route(nameof(VatRecordingIndividual))]
[HttpPost]
public async Task<IActionResult> VatRecordingIndividual([FromBody] VatRecordingIndividualRequestDto request, [FromQuery] long apiKeyId, [FromQuery] string? vatId)
{
  var response = await Mediator.Send(new CreateVatRecordingIndividualCommand { Model = request, ApiKeyId = apiKeyId, IndividualVatId = vatId });
  return StatusCode((int)response.StatusCode, response);
}

• 泛型类型Result<VatRecordingIndividualResponseDto>无法被Swashbuckle正确解析：Swashbuckle处理[ProducesResponseType]中的泛型类型时，若Result<T>结构复杂（比如包含未公开成员、自定义序列化逻辑，或者未正确生成对应XML注释），会导致无法生成有效Schema，进而引发API定义加载失败。
• VatRecordingIndividualResponseDto存在序列化问题：如果这个DTO类有循环引用、未标记可序列化特性，或者包含Swashbuckle不识别的类型（比如未配置的自定义枚举、复杂嵌套类型），会让Swagger解析响应类型时出错。
• Swashbuckle缺少泛型支持配置：默认配置下Swashbuckle对泛型类型的处理能力有限，需要显式配置来支持泛型Schema生成，否则无法解析Result<T>这类泛型响应。
• XML注释与[ProducesResponseType]存在隐性冲突：虽然XML注释本身能生效，但[ProducesResponseType]指定的类型和XML注释里<response>标签的描述，可能在Swashbuckle同时处理时引发解析异常。

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