.NET 6项目处理UBL 2.1发票的方案选型疑问

问题背景 #

我正开展.NET 6项目中处理UBL 2.1发票的调研工作。初步了解到一款常用.NET库UblSharp，但该库自2019年5月后未再更新，且仅支持UBL 2.1版本，后续若需升级至UBL 2.2及以上则需更换方案。另一种思路是使用XmlSchemaClassGenerator工具，基于UBL 2.1规范生成对应的C#类来处理发票。我倾向于后者，想请教该思路是否存在疏漏或过于理想化？

实际落地需注意的点 #

选择XmlSchemaClassGenerator的思路本身具备可行性，但有几个容易被忽略的实际问题，算不上疏漏，但会影响落地效率：

• UBL Schema复杂度适配：UBL 2.1的Schema包含大量复杂类型、继承关系和可选节点，工具默认生成的类可能出现命名冲突、冗余属性，或是将重复可选节点生成不够友好的集合类型。需要提前调整生成参数（比如--enable-data-contracts、--generate-document-types），或手动微调生成后的类，确保和业务逻辑匹配。
• 验证逻辑需自行实现：UblSharp自带UBL格式的合规验证能力，而生成类的方式下，你需要自行实现基于Schema的XML校验，或是在代码中补充业务规则校验，这部分额外工作量不能忽略。
• 版本升级的兼容成本：虽然理论上升级UBL 2.2只需重新生成类，但实际版本间Schema可能存在字段改名、结构调整，新生成的类和旧业务代码的兼容需要做适配，并非完全无缝切换。
• 序列化/反序列化细节调整：.NET XML序列化对命名空间、元素顺序要求严格，UBL发票对此要求更高。生成的类可能需要手动添加XmlRoot、XmlElement等特性，或是调整序列化配置，才能正确生成/解析符合规范的UBL XML。

总的来说，这个思路并非理想化，但需要提前评估上述几点的工作量，做好准备。

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