SuiteScript加载Leaflet依赖库报错：MarkerCluster提示L未定义

核心原因 #

MarkerCluster依赖全局的L对象，但SuiteScript的AMD加载机制可能未正确处理它对Leaflet的依赖，导致MarkerCluster加载时Leaflet还未完成全局挂载。

可行解决方法 #

1. 正确配置requireConfig的shim和路径 #

修改requireConfig.json，明确Leaflet的导出规则和MarkerCluster的依赖关系：

{
  "paths": {
    "leaflet": "./modules/leaflet/leaflet",
    "markercluster": "./modules/leaflet/leaflet.markercluster" // 根据实际文件名调整
  },
  "shim": {
    "leaflet": {
      "exports": "L" // 告知AMD Leaflet会暴露全局变量L
    },
    "markercluster": {
      "deps": ["leaflet"], // 指定MarkerCluster必须在Leaflet加载完成后再加载
      "exports": "L.markerClusterGroup"
    }
  }
}

随后在客户端脚本中同时引入两个库：

define(['leaflet', 'markercluster', 'N/search', 'N/runtime'],
  function(L, markerCluster, search, runtime) {
    // 正常使用MarkerCluster功能
    var clusterGroup = L.markerClusterGroup();
    // 你的业务代码逻辑...
  }
);

2. 动态加载MarkerCluster确保依赖就绪 #

如果shim配置不生效，可借助N/module模块动态加载MarkerCluster，确保Leaflet已全局可用：

define(['leaflet', 'N/search', 'N/runtime', 'N/module'],
  function(L, search, runtime, module) {
    // 确认L已存在后，再加载MarkerCluster
    module.load('./modules/leaflet/leaflet.markercluster').then(function() {
      var clusterGroup = L.markerClusterGroup();
      // 后续业务逻辑放在此回调内执行
    });
  }
);

3. 排查基础问题 #

• 核对MarkerCluster的文件路径是否与配置一致，部分版本的文件名是leaflet.markercluster.js，避免路径拼写错误。
• 确认Leaflet与MarkerCluster版本兼容：Leaflet 1.x需搭配MarkerCluster 1.x版本，版本不匹配也会引发异常。

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