使用SideLoading部署VS2017开发的Word Web Add-in启动失败求助

我帮你梳理几个实战中常用的排查和解决方法，都是侧加载这类插件时容易碰到的坑：

• 检查Manifest文件的URL配置
  首先确认manifest里的<SourceLocation>字段对应的URL绝对靠谱：

  • 必须是https协议！Word Web插件强制要求HTTPS，哪怕是本地调试也不能用HTTP。如果VS默认生成的是HTTP地址，要么开启项目的SSL选项，要么用工具把本地服务转发成HTTPS地址。
  • 仔细核对URL的路径，有没有拼写错误的文件夹名、文件名，确保和实际部署的插件页面路径完全匹配。

• 验证插件页面的可访问性
  直接在浏览器里打开<SourceLocation>的URL，看看能不能正常加载页面：

  • 如果打不开，先排查本地开发服务器（比如IIS Express）是否在运行，防火墙有没有拦截对应端口。
  • 企业网络环境下可能有代理或防火墙限制，试试切换到个人热点这类不受限的网络测试，排除网络层面的问题。

• 核对Manifest的权限与声明

  • 检查<Permissions>节点的设置：如果插件需要读写文档内容，至少要设置为ReadWriteDocument，别用默认的Restricted，权限不够会导致启动失败。
  • 确认<OfficeApp>下的必填项（比如<DefaultLocale>、<DisplayName>）没有特殊字符或格式错误，这些都可能导致Office解析manifest时出问题。

• 清理缓存
  缓存是侧加载插件的常见“隐形坑”：

  • 浏览器缓存：打开开发者工具（F12），勾选“禁用缓存”，或者直接用Ctrl+Shift+Delete清除缓存后刷新Word页面。
  • Office插件缓存：手动删除缓存文件夹：
    • Windows：%LOCALAPPDATA%\Microsoft\Office\16.0\Wef\
    • Mac：~/Library/Containers/com.microsoft.Word/Data/Library/Application Support/Microsoft/Office/16.0/Wef/
      删除后重新侧加载manifest文件。

• 检查VS2017的调试配置

  • 打开项目属性的“Web”选项卡，确保“SSL启用”已勾选，且SSL地址和manifest里的<SourceLocation>完全一致。
  • 如果是部署到测试服务器，确认服务器上的插件文件已正确上传，且MIME类型配置正确（比如.html、.js、.css的MIME类型要设置正确，否则服务器会返回错误的内容类型导致插件加载失败）。

• 查看浏览器控制台的错误详情
  这是定位问题最直接的方法：
  打开Word Web页面后按F12调出开发者工具，切换到“控制台”标签，点击插件的“Show Taskpane”按钮，看看控制台里的具体错误信息——比如404（文件找不到）、CORS跨域错误、脚本加载失败等，这些信息能帮你精准找到问题根源。

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