FastEndpoints框架中JsonIgnore条件属性的处理优化

在FastEndpoints框架中，开发者在使用DTO（数据传输对象）时经常会遇到需要控制JSON序列化输出的场景。特别是当DTO属性值为null时，我们可能希望不将该属性包含在响应中，以减少网络传输数据量。这通常可以通过[JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]特性来实现。

然而，在FastEndpoints的早期版本中，框架在处理带有条件的JsonIgnore特性时存在一个行为差异：无论条件如何设置，这些属性都会被从Swagger文档中移除。这实际上违背了JsonIgnore条件属性的设计初衷，因为条件属性应该只在特定条件下（如值为null时）才被忽略，而不是无条件地从文档中移除。

这个问题的技术背景在于：

1. JsonIgnore特性有两种使用方式：
   • 无条件忽略：[JsonIgnore]
   • 条件忽略：[JsonIgnore(Condition = ...)]
2. 在Swagger文档生成过程中，FastEndpoints的OperationProcessor对所有带有JsonIgnore特性的属性都进行了移除处理，没有区分是否有条件限制

这种处理方式会导致以下问题：

• 文档不准确：即使属性可能在某些情况下会被序列化（如非null值），文档中也不会显示该属性
• 开发困惑：开发者期望的条件忽略行为与实际文档表现不一致
• API使用者困惑：客户端开发者无法从文档中了解到某些可能存在的属性

在FastEndpoints v5.30.0.10-beta版本中，这个问题得到了修复。现在框架会：

1. 仅当JsonIgnore没有设置条件时，才从Swagger文档中移除属性
2. 对于带有条件的JsonIgnore，属性会保留在文档中，因为它在某些条件下仍然可能出现在响应中

这个改进使得FastEndpoints的Swagger文档生成行为更加符合System.Text.Json的序列化行为预期，为开发者提供了更准确的API文档。对于需要精细控制DTO序列化行为的场景，现在可以放心使用条件JsonIgnore而不用担心文档准确性问题。

在实际开发中，这个改进特别适用于以下场景：

• 部分填充的DTO：当API可能返回部分填充的DTO时，可以确保文档完整显示所有可能的字段
• 条件序列化：当某些字段只在特定条件下才需要序列化时，文档能正确反映这种可能性
• 渐进式API演进：在API演进过程中，可以更灵活地控制字段的可见性而不影响文档完整性

开发者现在可以更精确地控制DTO的序列化行为和文档表现，使得API设计更加灵活和符合预期。