解决Tileserver-GL在Node.js 20.15.0版本中的字体渲染问题

在构建Tileserver-GL的Docker镜像时，开发者可能会遇到一个典型的字体渲染问题。当使用Node.js 20.15.0版本构建镜像并运行后，地图预览图标无法正常显示，控制台会报出"Failed to load glyph range"的错误信息。

这个问题的核心在于Node.js 20.15.0版本与glyph-pbf-composite库的兼容性问题。具体表现为当系统尝试组合字体PBF（Protocol Buffers）时，messages.glyphs.encode方法会抛出异常，导致无法正确读取字体属性。

深入分析问题根源，我们可以发现：

1. 错误发生在glyph-pbf-composite库处理字体协议缓冲区的过程中
2. 该问题在Node.js 20.14.0版本中不存在，仅在升级到20.15.0后出现
3. 错误直接影响到了Noto Sans Regular等字体的加载

临时解决方案是将Dockerfile中的Node.js版本锁定为20.14.0。具体修改是在构建脚本中明确指定节点版本为20.14.0-1nodesource1。

Tileserver-GL团队在v4.12.0版本中彻底解决了这个问题。他们用@jsse/pbfont替换了原有的glyph-pbf-composite库，这个新库能够完美兼容Node.js 20.15.0及以上版本。经过多个开发者的验证，新版本在各种环境下（包括RHEL 9）都能正常工作。

对于开发者来说，这个案例提供了几个有价值的经验：

1. Node.js的小版本升级有时会带来意想不到的兼容性问题
2. 字体处理是地图服务中一个容易出问题的环节
3. 锁定依赖版本是解决兼容性问题的有效临时方案
4. 关注项目更新日志可以及时获取问题修复信息

建议所有使用Tileserver-GL的开发者尽快升级到v4.12.0或更高版本，以获得最佳的兼容性和稳定性。