WOPI服务不可用：.NET Core应用处理Office文件报错求助

一、通过日志定位核心问题 #

.wopitest能正常运行说明基础WOPI协议交互没问题，问题出在Office文件类型的特定处理环节，先从日志入手：

• 启用WOPI处理器API的详细日志：在appsettings.json中将Logging节点下的Microsoft.AspNetCore.Wopi级别设为Debug，同时记录请求的Headers和Body（注意过滤敏感信息）。重点关注Office Online服务请求API时的响应状态码（如400/401/500）、错误信息，以及是否缺失WOPI协议要求的字段。
• 抓浏览器端请求日志：打开宿主页面的F12开发者工具，在Network面板过滤Office相关请求（如/hosting/discovery、/wopi/files/xxx/contents），检查Discovery XML是否包含docx/xlsx对应的Action节点（如edit、view），以及请求处理器API时的错误详情。
• 核对WOPI响应头：Office文件要求返回X-WOPI-ItemVersion、X-WOPI-Size等特定响应头，确认这些字段值正确（比如文件大小与实际一致、版本号为有效字符串）。

二、修正Discovery XML地址 #

你使用的两个地址都是OneNote专属的Discovery服务，这类地址仅支持OneNote文件，不包含docx/xlsx等通用Office文档的处理规则。请替换为通用Office Online Discovery地址：

https://officeonline.microsoft.com/hosting/discovery

验证方法：访问该地址，查看XML中是否存在<action name="edit" ext="docx" ...>、<action name="edit" ext="xlsx" ...>这类节点，若不存在则说明地址错误，导致Office Online无法识别docx/xlsx文件类型，直接返回服务不可用。

三、调试WOPI处理器API关键流程 #

针对docx/xlsx请求，在处理器API中对以下环节加断点调试：

• 文件元数据接口（/wopi/files/{fileId}）：确认返回的BaseFileName后缀正确（如xxx.docx）、Size为文件实际字节数、Version为有效标识（如时间戳或版本号），UserCanEdit等权限字段符合当前用户权限。
• 文件内容接口（/wopi/files/{fileId}/contents）：确认返回的文件流完整无损坏，Content-Type设置正确（docx对应application/vnd.openxmlformats-officedocument.wordprocessingml.document，xlsx对应application/vnd.openxmlformats-officedocument.spreadsheetml.sheet）。
• AccessToken验证：Office Online的每个请求都会携带X-WOPI-AccessToken，确认API能正确验证令牌有效性，未因权限不足返回401错误。

四、常见坑点排查 #

• 文件读取权限：确保处理器API能正常读取docx/xlsx文件，文件所在目录有足够读写权限，无文件锁或损坏情况。
• CORS配置：若宿主页面与处理器API跨域，确认CORS策略允许officeonline.microsoft.com、*.officeapps.live.com等Office域名访问，避免请求被浏览器拦截。
• HTTPS要求：Office Online仅支持HTTPS的WOPI服务，确保API和宿主页面均使用有效HTTPS证书（测试环境需配置证书信任，避免自签证书被拒绝）。

内容的提问来源于stack exchange，提问作者A. Gladkiy