Mapbox/MapLibre为何自动请求两种字体？配置异常求助

架构老林

2026-6-25

解决字体请求自动追加 fallback 字体的问题

问题场景

配置的字体路径与字体列表如下：

"glyphs": "../resource/fonts/{fontstack}/{range}.pbf"

////////////////

"text-font": [ "Open Sans Regular"]

仅部署了Open Sans Regular字体文件，但系统自动生成包含Arial Unicode MS Regular的字体栈请求路径：resource/fonts/Open%20Sans%20Regular,Arial%20Unicode%20MS%20Regular/0-255.pbf，不符合预期的单一字体请求路径。

解决方案

明确禁用 fallback 字体：在text-font数组末尾添加空字符串，强制系统不使用任何备用字体。修改后的配置：
```
"text-font": [ "Open Sans Regular", "" ]
```
排查全局默认配置：部分地图渲染框架会默认将Arial Unicode MS Regular作为全局 fallback 字体。检查是否存在全局样式或初始化参数覆盖了局部text-font设置，确保局部配置优先级更高。
确认字体字符完整性：如果Open Sans Regular缺失需要渲染的字符（如特殊符号、非英文字符），系统会自动触发 fallback 机制加载额外字体。验证字体文件包含所有所需字符，避免触发自动补全。