Mapbox 中对聚类图层（如 conversationsLayer）直接使用 setFilter 无效，是因为聚类逻辑在数据源（Source）层面执行，而非图层（Layer）层面；真正生效的过滤必须作用于 GeoJSONSource.setData()，而非 map.setFilter()。
mapbox 中对聚类图层（如 conversationslayer）直接使用 `setfilter` 无效，是因为聚类逻辑在数据源（source）层面执行，而非图层（layer）层面；真正生效的过滤必须作用于 `geojsonsource.setdata()`，而非 `map.setfilter()`。
在 Mapbox GL JS 中，图层过滤（setFilter）仅影响渲染时的可见性判断，对已启用聚类（cluster: true）的 GeoJSONSource 完全无效——因为聚类过程发生在数据加载与索引阶段，早于图层渲染流程。你观察到“手动 filter() 特征数组能拿到正确结果，但 setFilter 却不显示”，正是这一机制导致的典型现象：过滤表达式被忽略，聚类点仍基于原始全量数据生成。
✅ 正确做法是：在数据源层面动态更新聚类数据集。你需要：
- 获取对应 GeoJSONSource 实例；
- 对原始特征数组（source._data.features 或更推荐的受控状态）执行 JavaScript 级别过滤；
- 调用 source.setData({ type: 'FeatureCollection', features: filteredFeatures }) 重置数据。
以下是重构后的可靠实现示例：
const routes = filters.routes.map(el => el.routeLongName);
const filterFeature = (feat: GeoJSON.Feature): boolean =>
routes.length === 0 || routes.includes(feat.properties?.route_long_name);
// ✅ 正确：过滤并更新 conversation source 数据
const conversationSource = mapbox.map.getSource(MapSources.conversationsSource) as mapboxgl.GeoJSONSource;
if (conversationSource) {
const allFeatures = mapState.conversationsFeatures; // 建议从状态管理中获取原始 Feature[]，避免依赖私有 _data
const filteredFeatures = allFeatures.filter(filterFeature);
conversationSource.setData({
type: 'FeatureCollection',
features: filteredFeatures
});
}
// ✅ 同理处理 routes source（若其也为聚类或需同步更新）
const routeSource = mapbox.map.getSource(MapSources.routesSource) as mapboxgl.GeoJSONSource;
if (routeSource) {
const routeFeatures = mapState.routesFeatures;
const filteredRoutes = routeFeatures.filter(filterFeature);
routeSource.setData({
type: 'FeatureCollection',
features: filteredRoutes
});
}
⚠️ 注意事项：
- 避免访问 source._data.features（私有属性，不稳定且可能为空）；应维护独立的 Feature[] 状态源；
- 若图层未启用聚类（如 routesLayer 是普通线图层），setFilter 依然有效——这解释了为何你的路由层“看似工作正常”；
- 聚类图层（如 conversationsLayer）的 setFilter 永远无法控制聚类点的生成逻辑，仅能影响非聚类子图层（如 cluster-count 文本标签）的渲染；
- 更新 setData() 后，Mapbox 会自动触发聚类重建，无需手动调用 source.cluster()。
总结：Mapbox 的聚类是数据源能力，不是图层样式能力。当遇到“过滤不生效”时，请优先检查该图层是否关联了 cluster: true 的 GeoJSONSource——若是，则必须转向 setData() 方案，这是官方文档明确推荐的唯一可靠路径。
