Open-XML-SDK 3.1.0 版本中 AddWorkbookPart() 方法的兼容性变化解析

在 Open-XML-SDK 从 2.18.0 升级到 3.1.0 版本后，部分开发者遇到了一个值得注意的行为变化：当使用 Package.Open() 方法以只写模式(FileAccess.Write)打开文件后，调用 AddWorkbookPart() 方法会抛出 System.IO.IOException 异常，提示"Cannot retrieve parts of writeonly container"。

这个变化实际上反映了 SDK 对 System.IO.Packaging 基础库行为的更严格遵循。在底层实现中，Package 类的 GetRelationshipsHelper 方法会检查包的访问模式，如果发现是只写模式，就会抛出这个异常。这个设计在 System.IO.Packaging 中已经存在多年，目的是防止在只写模式下尝试读取包内容导致的不一致行为。

在 Open-XML-SDK 2.18.0 版本中，这个检查可能没有被严格执行，使得开发者可以"绕过"这个限制。但在 3.1.0 版本中，SDK 更严格地遵循了底层库的设计规范，因此触发了这个异常。

对于需要创建新 Excel 文件的场景，正确的做法是使用 SpreadsheetDocument.Create 方法，而不是直接操作 Package。这个方法内部会处理好包的访问模式问题。如果确实需要直接操作 Package 对象，应该使用 FileAccess.ReadWrite 模式而不是 FileAccess.Write。

这个变化提醒我们，在升级 SDK 版本时，需要特别注意那些原本可能不符合规范但被容忍的行为。这类行为在新版本中可能会被修正，导致现有代码出现兼容性问题。对于文件操作这类关键功能，遵循官方推荐的使用模式通常是最安全可靠的做法。

对于遇到这个问题的开发者，解决方案很简单：要么改用 SpreadsheetDocument.Create 方法创建文档，要么在 Package.Open 时使用 ReadWrite 模式。这两种方法都能避免这个异常，同时保证功能的正常运作。