Ruby on Rails中WOPI Host实现问题：iframe加载Word Online无服务器请求

嘿，我来帮你梳理这个问题——你遇到的核心情况是Office Online客户端压根没发起对WOPI Host的请求，导致文档一直卡在加载状态。结合你的场景，我整理了几个关键排查方向：

1. 先确认WOPISrc参数的正确性 #

Office Online完全依赖WOPISrc来定位你的WOPI Host，这里最容易出问题：

• 确保WOPISrc是完全URL编码的完整地址，比如特殊字符（&、空格等）必须转义成%26、%20这类编码值。你的示例里WOPISrc后面的URL被截断了，一定要保证它是可直接访问的完整路径。
• 注意：Office Online会先请求/wopi/files/:id元数据接口（不是你已经实现的/contents接口），再去拉取内容。如果你只做了contents接口而没实现元数据接口，请求根本不会触发。

2. 再核对CSPP白名单配置 #

虽然你说域名在白名单里，但细节很重要：

• 白名单里的域名要和WOPISrc里的完全一致，比如是否包含https://，子域名是否匹配（比如sgdevwopi和sgdevwopi.yourdomain.com是两个不同的域名）。
• 你的服务器必须用有效的HTTPS证书，Office Online不会信任自签证书，这会直接导致请求被拦截。

3. 检查Rails的CORS配置 #

跨域请求是WOPI的核心，必须正确配置：

• 用rack-cors gem来处理CORS，确保允许来自Office Online域名（比如https://word-view.officeapps-df.live.com）的请求。
• 响应头里必须包含：
  • Access-Control-Allow-Origin：指定Office Online的域名或者用*（生产环境不推荐）
  • Access-Control-Allow-Methods：至少包含GET、POST
  • Access-Control-Allow-Headers：要覆盖WOPI相关的头，比如X-WOPI-Override、X-WOPI-AccessToken等

4. 确保元数据接口实现正确 #

Office Online第一步就是请求/wopi/files/:id获取元数据，这个接口必须返回符合规范的JSON，至少包含这些字段：

{
  "BaseFileName": "your-document.docx",
  "Size": 123456, // 文档的字节大小
  "UserId": "unique-user-id",
  "UserFriendlyName": "Your Name",
  "AllowExternalMarketplace": false
}

如果这个接口返回404、500或者格式错误，Office Online会直接停止后续请求，自然不会访问/contents接口。

5. 用浏览器开发者工具抓包排查 #

打开浏览器F12的开发者工具，切换到Network标签：

• 过滤XHR请求，看看有没有针对你的WOPI Host的请求。如果有，检查响应状态码和内容；如果没有，说明Office Online没发起请求，大概率是WOPISrc参数错误或者白名单配置问题。
• 再看Console标签，有没有CORS相关的错误提示，这是跨域配置错误的典型表现。

6. 验证Discovery文档的正确性 #

确保你使用的Office Online Viewer URL是从官方Discovery文档里获取的，并且对应支持docx格式的查看器。如果Viewer URL不对，也可能导致请求不触发。

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