Autodesk Viewer中DWG图纸字体未生效问题求助（添加引用后报错）

排查与修复步骤 #

• 验证字体文件有效性
  检查客户提供的字体文件是否完整无损坏，可通过本地字体预览工具打开确认渲染正常。部分DWG会依赖字体的特定字重或样式（如粗体、斜体），若仅添加常规体，对应样式的文字仍会失效。
• 核对字体引用路径
  确保字体文件的引用路径完全合规：
  • 路径避免中文、空格或特殊字符，建议用下划线/短横线替代
  • 确认相对路径基于Viewer的资源加载根目录，而非本地文件系统路径
  • 检查服务器端已正确部署字体文件，可在浏览器开发者工具的Network面板中查看字体加载状态，若返回404则路径或部署存在问题
• 检查Viewer字体加载配置
  初始化Viewer时需正确配置字体路径，且字体名必须与DWG中使用的名称完全匹配（区分大小写）：

  Autodesk.Viewing.Initializer({
    env: 'AutodeskProduction',
    accessToken: 'YOUR_TOKEN',
    fonts: [
      {
        name: 'DWG内字体名', // 需与AutoCAD中文字样式的字体名完全一致
        url: '/assets/fonts/custom-font.ttf'
      }
    ]
  }, function() {
    // 初始化Viewer实例
  });
  

• 强制字体映射
  若DWG使用了字体别名，可通过字体映射功能强制替换：

  Autodesk.Viewing.theExtensionManager.registerExtension('CustomFontMap', {
    load: function() {
      this.viewer.fontMapper.addFontMapping('DWG显示的字体名', '自定义字体名');
      return true;
    }
  });
  

• 清除缓存
  浏览器可能缓存旧资源，尝试清除缓存或用无痕模式重新加载页面测试。

针对本次特例的额外排查 #

由于此前处理其他图纸正常，仅本次异常，需确认：

• 本次DWG是否使用了特殊字体（如SHX字体、复合字体），这类字体需要特殊处理逻辑
• 图纸内嵌套块参照的文字是否使用了独立字体样式，需单独核对字体引用

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