如何将HTTP获取的PDF生成有效URL加载至Forge Viewer
问题背景
- 项目从HTTP接口拉取PDF时,配置
responseType: 'arraybuffer'获取原始二进制内容,对应代码:return this.http.get(path, { observe: 'response', responseType: 'arraybuffer' }); - 拿到响应后将二进制内容封装为
application/pdf类型的Blob对象:let blob: Blob = new Blob([response.body], { type: 'application/pdf' }); - 调用
window.URL.createObjectURL生成的本地资源URL无.pdf后缀,Viewer无法识别文件类型;手动为URL拼接.pdf后缀后,页面会抛出Cannot read property 'getData' of undefined报错,错误栈指向Viewer3D.js内onDone回调中model.getData()的执行逻辑。 - 当前Viewer初始化时配置
env: 'Local',仅当传入带正确后缀的静态托管PDF路径(例如https://localhost:3000/Content/Documents/qcad1.pdf)时可以正常加载,无法通过Model Derivative管线处理PDF,避免矢量数据丢失。
报错核心原因
window.URL.createObjectURL生成的是内存映射的blob协议URL,手动拼接路径后缀不会改变浏览器对该URL的解析规则。拼接后缀后的地址对浏览器而言是完全无效的路径,Viewer发起请求时无法匹配到对应的Blob内存资源,最终导致模型加载完成回调拿到的model对象为undefined,才会触发读取getData属性的报错。- Viewer的PDFLoader会根据URL后缀判断文件类型,Blob协议URL本身不携带后缀信息,仅靠字符串拼接后缀无法通过Loader的类型校验,也无法建立有效资源映射。
可落地的实现方案
- 方案1:通过本地路由映射生成带PDF后缀的可访问URL
- 前端维护一个全局内存对象,将随机生成的带
.pdf后缀的文件名作为key,对应值为存储的Blob对象 - 配置开发服务器/生产环境静态服务的路由拦截规则,所有匹配
/*.pdf的请求都从全局内存中取出对应Blob,设置响应头Content-Type: application/pdf后返回内容 - 最终传给
loadModel的URL是符合静态路径规则的带后缀地址,既可以通过Loader的类型识别,也能正常拉取到Blob的实际内容
- 前端维护一个全局内存对象,将随机生成的带
- 方案2:直接向Loader传入本地Blob二进制内容,规避URL依赖
- 不再依赖
createObjectURL生成资源地址,调用loadModel时在options参数中明确指定fileType: 'pdf',强制让Loader使用PDF解析逻辑 - 拦截PDFLoader的资源请求流程,将原本需要从URL拉取二进制的逻辑,替换为直接读取本地Blob的arraybuffer内容
- 这种方式不需要生成真实可访问的网络URL,完全适配本地环境的加载逻辑,从根源上避免后缀匹配的问题
- 不再依赖
- 方案3:配置带鉴权头的直链加载,跳过本地Blob转存环节
如果原本的PDF就存储在带权限校验的远端存储中,不需要中转成本地Blob,可直接通过loadModel加载存储直链:- 传入存储端的PDF直链作为url参数
- 在options中新增
headers字段,塞入Authorization: Bearer <鉴权token>的请求头配置 - Viewer内部的资源加载逻辑会自动携带配置的请求头发起请求,可直接访问需要鉴权的存储地址,不需要中间转存为本地Blob
高频踩坑提醒
- 不要直接给
createObjectURL生成的blob协议URL手动拼接后缀,浏览器会严格按照原始blob映射规则解析地址,拼接后缀后的路径完全无效,必然触发加载失败 - 本地模式下Viewer默认不携带自定义鉴权头访问资源,需要在
loadModel的options中显式配置headers字段,才能正常拉取带权限校验的远端文件 - 内存中存储的Blob对象需要保持可访问状态,不能被浏览器垃圾回收,否则会再次出现模型对象为undefined的报错
内容的提问来源于stack exchange,提问作者Benito
相关产品推荐
相关产品推荐

