WOPI Host部署问题：本地监听正常，非本地OWA访问失败求助

听起来你已经搞定了本地WOPI监听器的基础功能，现在卡在远程OWA的连通上——我之前帮同事调试过类似的场景，给你列几个优先级最高的排查方向：

1. 先确认网络连通性（最常见的坑） #

远程OWA服务器根本连不上你的WOPI Host是大概率事件，别先纠结协议细节，先测通网络：

• 在OWA服务器上用命令测试端口可达性：Test-NetConnection <你的WOPI Host公网/内网IP> -Port 8080（Windows环境），或者telnet <你的WOPI HostIP> 8080
• 检查你的WOPI Host本地防火墙：是不是只允许了127.0.0.1访问8080？要改成允许OWA服务器的IP段或者所有IP（测试阶段先放开）
• 中间的网络设备（比如公司路由器、防火墙）有没有放行8080端口的入站流量？很多企业网络默认会封锁非标准端口，可能需要申请开放

2. 验证WOPI协议的核心校验逻辑 #

本地访问可能跳过了WOPI的安全校验，但OWA会严格执行这部分，你的监听器可能没处理到位：

• 检查监听器有没有正确处理X-WOPI-Proof和X-WOPI-ProofOld请求头：OWA会用这些头验证请求的合法性，要是你的监听器没实现校验逻辑，直接返回403是正常的
• 确认WOPI请求的目标资源路径：OWA发起的请求路径是不是和你本地测试的/sometest匹配？比如是不是监听器只配置了/sometest的路由，而OWA请求的是其他路径？

3. 跨域（CORS）配置检查 #

如果OWA和WOPI Host不在同一个域名下，浏览器会触发CORS限制，导致请求失败：

• 确保你的WOPI监听器返回正确的CORS响应头：
  • Access-Control-Allow-Origin：设置成OWA的完整域名（比如http://<your-owa-domain>），测试阶段可以临时设为*
  • Access-Control-Allow-Headers：必须包含WOPI的自定义头，比如X-WOPI-Proof,X-WOPI-ProofOld,X-WOPI-Request,X-WOPI-TimeStamp等
• 可以用浏览器的开发者工具（Network面板）看OWA页面发起的WOPI请求有没有CORS报错

4. OWA端的WOPI配置验证 #

别只盯着自己的WOPI Host，OWA那边的配置也可能出问题：

• 登录Exchange管理中心，确认已经添加了你的WOPI Host作为外部WOPI服务器
• 检查WOPI服务器的配置：是不是填写了正确的WOPI Host地址（要能被OWA服务器访问到的IP/域名），有没有启用对应的文件类型关联（比如Excel、Word）
• 用Exchange PowerShell命令验证配置：Get-WopiServer，看看返回的信息里你的WOPI Host状态是不是正常

5. 开启详细日志定位问题 #

如果上面的排查都没找到问题，就靠日志说话：

• 打开WOPI监听器的详细日志，记录所有入站请求的头部、路径、响应状态码
• 对比本地测试的请求和OWA发来的请求，看看差异在哪里：比如请求头少了什么？路径不对？还是监听器直接返回了错误码？

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