关于Microsoft WOPI（Word）是否支持容器内重名文件的技术咨询

结论：Microsoft WOPI协议及Word等Office Online客户端不支持同一容器（文件夹）内存在重名文件

原因说明 #

WOPI协议虽以file_id作为文件的唯一标识，但Office客户端（如Word Online）在与WOPI服务器交互时，会依赖文件名完成界面展示、操作校验等核心逻辑。同一容器下的重名文件会引发以下问题：

• 客户端无法精准区分不同文件，打开、保存操作可能指向错误目标；
• 文件列表展示出现重复条目，造成用户混淆；
• 版本管理、协作编辑等功能会因文件名冲突出现异常。

适配建议 #

针对你们文档管理系统支持同文件夹重名的场景，可参考两种处理方向：

• 适配改造：在WOPI服务层做转换处理，给每个重名文件生成唯一的展示文件名（比如自动添加(1)、(2)这类区分后缀），同时所有WOPI交互全程使用文件唯一ID而非原始文件名，确保传递给Office客户端的文件名在同一容器下唯一；
• 逻辑调整：若业务允许，修改文档管理系统规则，保证同一容器内文件名唯一，这样可直接适配WOPI规范，避免额外开发成本和兼容性风险。

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