通过WOPI打开/编辑LibreOffice生成的特定docx文件时出错

1. 文件格式与结构校验 #

• 用7-Zip解压正常docx和异常docx文件，对比[Content_Types].xml、word/document.xml、_rels/.rels等核心文件的内容，重点排查是否存在OOXML规范不兼容的节点、命名空间错误，或是LibreOffice生成的非标准标记。
• 使用Office Open XML SDK（如C#的DocumentFormat.OpenXml库）加载异常文件，检查是否抛出格式验证错误，确认文件是否符合ISO/IEC 29500标准。
• 检查Blob存储中文件的元数据：确保Content-Type设置为application/vnd.openxmlformats-officedocument.wordprocessingml.document，同时确认文件未被标记为只读属性。

2. WOPI交互流程与元数据检查 #

• 核对WOPI GetFileInfo接口的返回参数：重点确认ReadOnly、UserCanWrite、SupportsUpdate这几个字段是否正确，排查异常文件是否被错误标记为只读，导致Office客户端跳过Post更新请求。
• 完整追踪WOPI交互日志：从文件打开到关闭的所有请求都要记录，查看异常文件在打开阶段是否存在隐藏的4xx/5xx错误（比如GetFile接口返回的文件流不完整、校验和不匹配），或是Office客户端在触发Post前有失败请求。
• 验证文件锁逻辑：检查异常文件打开时是否成功获取锁，关闭时的Unlock请求是否携带正确的锁ID，排查是否因锁冲突导致客户端直接跳过Post解锁。

3. LibreOffice处理环节排查 #

• 检查LibreOffice的调用参数：确认是否使用了--headless、--convert-to docx等基础参数，尝试添加严格遵循OOXML的选项（如--strict），避免生成兼容模式的文件。
• 做中间验证：将LibreOffice处理后的文件在本地Office中编辑并保存，再上传到Blob存储，测试WOPI是否正常工作，以此判断是LibreOffice生成的文件本身有问题，还是上传Blob过程中文件损坏。
• 尝试升级LibreOffice版本：不同版本对OOXML的支持差异较大，切换到最新稳定版或使用LibreOffice SDK处理文件，排查命令行调用的潜在问题。

4. 细节场景验证 #

• 检查文件大小：确认异常文件是否超出WOPI服务的大小限制，或是Blob存储返回的文件大小与实际文件不一致，导致客户端无法完整加载。
• 测试无修改关闭场景：打开异常文件后不做任何修改直接关闭，查看是否正常调用Unlock，对比编辑后关闭的流程差异，判断是否是编辑操作触发了特定错误导致跳过Post。
• 修复文件测试：用本地Office打开异常文件，修改少量内容后保存，再上传到Blob存储，测试WOPI是否正常工作，定位是文件初始结构问题还是特定内容导致的异常。

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