去年接手一个合同管理后台需求清单里躺着一条“附件上传后要在网页里直接打开不要每次下载到本地”。业务方说得轻巧我听完心里一颤若依RuoYi-Vue这类前后端分离后台文件上传下载都是现成的但“在线查看”四个字背后牵扯到文件格式、转换环境、权限边界、跨域策略……每一项都是能让人加班的坑。这篇文章就记录我在若依项目里把文档在线查看从0到1落地的全过程包括选型思路、集成步骤、踩坑修复和安全加固。如果你刚把若依跑通、正准备做文件预览的开发者这篇文章能让你少走不少弯路。1. 先想清楚文档在线查看到底要解决什么问题1.1 企业后台里的“附件只能下载”尴尬大多数基于若依搭建的管理系统文件模块一开始都是“上传 下载”。上传走若依的FileUploadUtils下载走文件流或静态资源映射。单机用没问题但随着使用深入业务方迟早会提新要求合同管理员不