Leaflet 地图初始化后显示空白的6种原因及解决办法

作者： 还是大剑师兰特 ，曾为美国某知名大学计算机专业研究生，现为国内GIS领域高级前端工程师，优快云知名博主，深耕openlayers、leaflet、mapbox、cesium，canvas，echarts等技术开发，欢迎加微信（gis-dajianshi），一起交流。

查看本专栏目录

Leaflet 地图初始化后显示空白（无瓦片加载），且控制台无报错，这种情况通常不是 JavaScript 语法错误或网络请求失败（否则会有报错），而是由一些“静默失败”的配置或环境问题引起。以下是常见原因及对应的排查与解决办法：

---

一、最常见原因：容器尺寸为 0

原因：

Leaflet 的地图容器（如 <div id="map">）在初始化时 宽高为 0（例如 CSS 未设置高度、父元素未布局等），导致地图无