WOPI集成加载Office文档异常 已排查BaseFileName需含扩展名

已确认的核心问题 #

• BaseFileName必须包含文件扩展名：你的checkFileInfo接口返回的BaseFileName值为"123456"，缺少.docx这类文件扩展名。Office服务依赖扩展名识别文档类型，没有扩展名会导致无法正常加载文档内容，这是当前明确的问题之一。

其他需排查的错误点 #

1. Access Token不一致 #

表单的action URL中携带了access_token=DASDASAS，但表单内的隐藏域access_token值为1，两者不匹配会触发权限验证失败。必须保证两处的access_token完全一致，且处于有效状态。

2. Access Token有效期过短 #

access_token_ttl设置为1000（单位为秒），仅约16分钟。如果文档加载耗时较长，或者后续操作时token已过期，会导致请求中断，页面停留在加载状态。建议根据实际业务场景延长有效期。

3. 表单未触发提交 #

需确认前端是否执行了表单提交操作（比如通过JS调用document.getElementById('office_form').submit()）。如果表单没有被提交，Office服务无法获取用户ID、所有者ID等必要信息，会一直停留在初始加载界面。

4. WOPISrc URL格式错误 #

检查action参数中的WOPISrc值，确保{host_url}是完整且正确的后端服务域名，并且URL已做正确的URL编码（若包含特殊字符），避免Office服务无法解析后端地址。

5. 文档内容完整性 #

虽然checkFileInfo返回了Size字段，但需确保后端的/wopi/files/{fileId}接口在Office发起文件内容请求时，能返回完整、未损坏的Office文档内容。如果文档本身损坏，也会导致加载失败。

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