WordPress站点使用Leaflet聚类标记时报L.markerClusterGroup不是函数错误

这个报错的核心原因是MarkerCluster扩展没有成功挂载到Leaflet的全局L对象上，可按以下维度逐一排查解决：

• 校准脚本加载顺序
  Leaflet核心库必须优先于MarkerCluster插件脚本执行。如果使用WordPress的官方脚本入队机制加载资源，需要给MarkerCluster脚本显式声明依赖关系，避免系统自动调整脚本顺序导致插件在核心库加载前就执行，最终无法扩展全局L的方法。可在浏览器开发者工具的源码面板，确认两个脚本的实际执行先后顺序。
• 检查脚本加载完整性
  打开开发者工具的网络面板，确认leaflet.markercluster.js的请求状态为正常200，无被拦截、被压缩合并插件损坏、被安全插件过滤的情况。很多全局生效的性能优化插件、安全插件会跨主题处理所有页面的外部脚本，这也是你切换空白主题后问题仍然存在的核心可能诱因。
• 排查全局L对象冲突
  检查站点是否存在其他脚本重复加载不同版本的Leaflet库，比如其他地图插件、主题自带的内嵌Leaflet，可能在MarkerCluster脚本执行完成后，重新实例化覆盖了全局L对象，导致之前挂载的markerClusterGroup方法丢失。可在控制台直接输入L.version，校验当前全局L的版本是否与你代码中引用的1.3.1版本一致。
• 调整初始化执行时机
  不要将地图初始化逻辑直接写在页面顶部的内联脚本中，将initMap()方法绑定到window.onload事件上，等所有外部脚本、DOM资源完全加载完成后再执行地图初始化，避免因为脚本异步加载、下载延迟导致的方法找不到问题。

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