Autodesk Build PDF图纸加载Forge Viewer失败的排查与解决建议

核心问题点 #

• URN编码格式错误：标准Base64编码含URL不安全字符（如+、/），导致Forge服务无法解析
• 缺失PDF渲染扩展：Forge Viewer默认未启用Autodesk.PDF扩展，无法渲染PDF文件
• 权限或令牌问题：访问令牌可能缺少viewables:read或data:read权限，无法获取图纸资源
• 视图节点获取逻辑问题：getDefaultGeometry()可能无法正确识别PDF的视图节点

具体解决步骤 #

1. 修正URN编码方式

使用URL安全的Base64编码（替换+为-、/为_，移除末尾的=），再拼接urn:前缀：

// 转换为URL安全的Base64编码
function encodeUrnForViewer(rawUrn) {
    const base64 = btoa(rawUrn);
    return `urn:${base64.replace(/\+/g, '-').replace(/\//g, '_').replace(/=+$/, '')}`;
}

// 从Sheets API返回的viewable.urn生成正确的documentId
const rawViewableUrn = "urn:adsk.bimdocs:seed:a6deb3c3-430d-494b-8de3-414096c0704f";
const documentId = encodeUrnForViewer(rawViewableUrn);

2. 加载PDF扩展

在初始化Viewer时启用Autodesk.PDF扩展，或在加载文档前动态加载：

// 初始化Viewer时启用扩展
const viewer = new Autodesk.Viewing.GuiViewer3D(container, {
    extensions: ['Autodesk.PDF']
});

// 或动态加载扩展后再加载文档
viewer.loadExtension('Autodesk.PDF').then(() => {
    Autodesk.Viewing.Document.load(documentId, onDocumentLoadSuccess, onDocumentLoadFailure);
});

3. 验证访问令牌权限

确保访问令牌包含以下至少一个权限：

• viewables:read：允许查看模型视图资源
• data:read：允许读取项目内数据资源

4. 调整视图节点加载逻辑

替换getDefaultGeometry()为搜索几何视图节点的方式，确保正确获取PDF视图：

function onDocumentLoadSuccess(doc) {
    const root = doc.getRoot();
    // 搜索所有几何类型的视图节点
    const viewables = root.search({ type: 'geometry' });
    if (viewables.length > 0) {
        viewer.loadDocumentNode(doc, viewables[0]);
    } else {
        console.error("未找到可渲染的视图节点");
    }
}

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