切换至streamingV2 API后单页加载两个Viewer异常问题求助

核心问题定位 #

切换到streamingV2 API与AutodeskProduction2环境后，页面内多个Viewer实例（3D+2D）出现随机单实例正常、另一实例报网络/访问错误的问题，本质是StreamingV2环境下Viewer实例间存在共享资源冲突——比如全局配置复用、网络请求池互斥、token上下文干扰，导致无法同时正确获取模型资源。

可行解决方案 #

1. 为每个Viewer实例独立指定配置 #

不要全局设置Viewer的环境与API参数，而是在初始化每个实例加载模型时，通过loadDocumentNode的options参数单独传入，彻底隔离实例配置：

// 初始化3D Viewer
const viewer3D = new Autodesk.Viewing.GuiViewer3D(document.getElementById('viewer3d-container'));
viewer3D.start();
viewer3D.loadDocumentNode(doc, viewable3D, {
    env: 'AutodeskProduction2',
    API: 'streamingV2',
    accessToken: YOUR_ACCESS_TOKEN
});

// 初始化2D Viewer
const viewer2D = new Autodesk.Viewing.GuiViewer3D(document.getElementById('viewer2d-container'));
viewer2D.start();
viewer2D.loadDocumentNode(doc, viewable2D, {
    env: 'AutodeskProduction2',
    API: 'streamingV2',
    accessToken: YOUR_ACCESS_TOKEN
});

2. 避免复用同一个Document实例 #

如果之前是共享Autodesk.Viewing.Document加载不同视图，改为为每个Viewer单独加载对应文档，避免实例间的文档上下文冲突：

// 3D Viewer单独加载文档
Autodesk.Viewing.Document.load(
    YOUR_3D_URN,
    (doc) => {
        const viewable = doc.getRoot().getDefaultGeometry();
        viewer3D.loadDocumentNode(doc, viewable, { env: 'AutodeskProduction2', API: 'streamingV2', accessToken: token });
    },
    (err) => console.error('3D加载失败:', err)
);

// 2D Viewer单独加载文档
Autodesk.Viewing.Document.load(
    YOUR_2D_URN,
    (doc) => {
        const viewable = doc.getRoot().getDefaultGeometry();
        viewer2D.loadDocumentNode(doc, viewable, { env: 'AutodeskProduction2', API: 'streamingV2', accessToken: token });
    },
    (err) => console.error('2D加载失败:', err)
);

3. 检查Token权限与复用问题 #

StreamingV2对token的校验更严格，确保使用的access token包含data:read和viewables:read权限；如果是短期token，避免在多个实例间复用，可尝试为每个Viewer请求独立的有效token。

4. 串行初始化Viewer实例 #

尝试在第一个Viewer完全加载完成后，再初始化第二个Viewer，避免同时发起的网络请求抢占资源：

// 监听3D Viewer加载完成事件，再初始化2D
viewer3D.addEventListener(Autodesk.Viewing.GEOMETRY_LOADED_EVENT, () => {
    init2DViewer(); // 这里调用你的2D Viewer初始化逻辑
});

验证要点 #

• 查看浏览器控制台的网络请求：如果是401报错，排查token权限；404则确认模型的StreamingV2格式输出是否正常；500则可能是服务端临时问题
• 确认目标模型是通过Model Derivative API的StreamingV2格式生成的，旧的derivativeV2输出可能不兼容新环境

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