使用Node Mapbox SDK遇RequestError：listener参数需为函数

你遇到的是Mapbox JS SDK新版本和旧文档/类型定义不一致的问题，核心是forwardGeocode的参数命名与实际实现、类型提示存在差异。

问题根源 #

新版本SDK中，forwardGeocode的类型提示显示参数为GeocodeRequest类型，但源码里仍用config作为参数名，导致文档、类型定义和实际实现出现错位，这属于SDK本身的同步滞后问题。

解决步骤 #

1. 确认版本并校验代码写法
   如果你用的是@mapbox/mapbox-sdk v1.x及以上版本，你的代码写法本身是正确的——直接传入包含query、limit等字段的配置对象即可。如果运行报错，先排查：

   • 确保process.env.MAPBOX_TOKEN已正确加载，不是空值或无效Token；
   • 执行npm list @mapbox/mapbox-sdk确认依赖版本，避免子版本不一致。

2. 类型环境下的适配（如TS）
   要是TypeScript环境下类型提示报错，手动指定参数类型即可：

   import { GeocodeRequest } from '@mapbox/mapbox-sdk/services/geocoding.js';
   
   // ...
   
   const requestParams = /** @type {GeocodeRequest} */ ({
     query: 'Paris, France',
     limit: 2
   });
   
   geocoder.forwardGeocode(requestParams).send()
   

3. 回退到兼容文档的旧版本
   如果新版本的不一致问题严重影响开发，可暂时回退到v0.x版本，此时forwardGeocode参数完全对应文档里的config对象：

   npm install @mapbox/mapbox-sdk@0.15.0
   

4. 排查其他潜在问题
   调用接口后根据错误信息定位：

   • 出现401 Unauthorized：检查Token是否有效、是否有地理编码权限；
   • 参数错误：确认limit不超过10（Mapbox API限制）、query格式合法；
   • 内部依赖报错：删除node_modules和package-lock.json后重新安装依赖。

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