做零工和招聘那會兒地圖這塊差點被高德焊死。坐標(biāo)解析、POI 搜索全調(diào)高德等業(yè)務(wù)做到別的城市發(fā)現(xiàn)高德配額天天被爆換百度要動十幾個調(diào)用點誰都不想接這活。后來我在腳手架里抽了個qkl-channel模塊把地圖服務(wù)做成注冊表 配置切換廠商是實現(xiàn)類切換只改一個配置項連日限額都按廠商按天計。這套東西落地后換廠商十分鐘搞定再沒求過人。注冊表讓 Spring 自動收集所有地圖廠商核心就一句話把廠商實現(xiàn)扔進(jìn) Spring 容器注冊表自動收集。寫接口各廠商實現(xiàn)Spring 啟動時把List注入構(gòu)造器按 provider 名存進(jìn) Map。ComponentpublicclassMapClientRegistry{privatefinalMapclients;publicMapClientRegistry(Listlist){this.clientslist.stream().collect(Collectors.toMap(c-c.provider().toLowerCase(Locale.ROOT),Function.identity(),(a,b)-a));}publicMapClientrequire(Stringprovider){MapClientclientclients.get(providernull?:provider.toLowerCase(Locale.ROOT));if(clientnull){thrownewQklBizException(ErrorCode.MAP_PROVIDER_UNAVAILABLE,不支持的地圖廠商: provider);}returnclient;}publicListproviders(){returnclients.keySet().stream().sorted().toList();}}好處立竿見影新接一家廠商 寫一個實現(xiàn)類注冊表一行不用改。Collectors.toMap的第三個參數(shù)(a, b) - a是保底真出現(xiàn)兩個同 provider 的實現(xiàn)不至于啟動就炸。門面統(tǒng)一 API切換只改配置業(yè)務(wù)方不關(guān)心你背后是高德還是百度它只認(rèn)geocode(address)、searchPoi(keyword, city)這一套。門面服務(wù)里做開關(guān)、默認(rèn)廠商、活躍客戶端解析ServiceRequiredArgsConstructorpublicclassMapChannelService{privatefinalMapClientRegistryregistry;privatefinalSysConfigWriterconfigWriter;privatefinalSysConfigReaderconfigReader;privatefinalMapQuotaServicemapQuotaService;publicbooleanisEnabled(){StringenabledconfigReader.get(map,enabled,false);returntrue.equalsIgnoreCase(enabled)||1.equals(enabled);}publicStringcurrentProvider(){returnconfigReader.get(map,provider,amap);}publicMapClientactiveClient(){if(!isEnabled()){thrownewQklBizException(ErrorCode.MAP_MODULE_DISABLED,地圖通道未開啟);}returnregistry.require(currentProvider());}publicMapGeoResultgeocode(Stringaddress){if(!StringUtils.hasText(address)){thrownewQklBizException(ErrorCode.VALIDATION_ERROR,地址不能為空);}MapClientclientactiveClient();// 調(diào)用前先占額度超限直接拋異常不發(fā)起真實請求mapQuotaService.consume(currentProvider(),MapApiType.GEOCODE);returnclient.geocode(address);}}門面里每個接口都走校驗 → 取活躍客戶端 → 占額度 → 調(diào)廠商四步順序不能反額度沒占就發(fā)請求超限了錢照花校驗放最前面空地址就別浪費一次配額。額度用完了怎么辦換廠商就是一條配置日額度設(shè)計成0 不限是有原因的。地圖廠商的免費額度天天變高德某天配額被活動流量打爆我的處理不是去后臺調(diào)大限額那只是掩耳盜鈴而是直接切廠商// 管理員后臺一次操作把默認(rèn)廠商從 amap 切到 tencentconfigWriter.upsert(map,provider,tencent,默認(rèn)地圖廠商,false,text);切換是無感的因為所有業(yè)務(wù)只依賴MapChannelService.geocode/poi這套門面廠商實現(xiàn)換了、調(diào)用方一行不用改。這也是我堅持把額度做成按廠商獨立計量的原因每家廠商的配額賬單獨算切過去的那家配額是滿的不會出現(xiàn)切完接著超限的尷尬。還有個細(xì)節(jié)channelView()里看板把三家 key、四個維度的配額、當(dāng)前廠商全列出來運營在后臺一眼看到高德 geocode 用了 87%、騰訊還沒動該切誰一目了然。key 統(tǒng)一脫敏展示避免運維截圖把密鑰泄露到聊天群里。配置全部走SysConfigReader/Writer開關(guān)、默認(rèn)廠商、三家 key 都存配置中心key 落庫前脫敏upsert(..., true, text)那個 true 就是敏感標(biāo)記。生產(chǎn)環(huán)境切廠商就是改一條配置連發(fā)布都不用。日限額Redis Hash 按廠商按天計量地圖廠商免費額度有限超了要錢還限流。我在調(diào)用前先占用一次額度超限直接拋異常并把占的額度還回去publicvoidconsume(Stringprovider,MapApiTypeapi){StringpnormalizeProvider(provider);longlimitdailyLimit(api);StringkeydailyKey(p);// map:quota:20261010:amapLongusedredisTemplate.opsForHash().increment(key,api.code(),1L);touchExpire(key);if(limit0used!nullusedlimit){redisTemplate.opsForHash().increment(key,api.code(),-1L);// 回滾thrownewQklBizException(ErrorCode.MAP_QUOTA_EXCEEDED,api.label()今日調(diào)用額度已用盡限額 limit 次);}}接口維度用枚舉收斂配置 key 跟枚舉綁定想加維度就加一個枚舉值publicenumMapApiType{GEOCODE(geocode,地理編碼,quota.geocodeDaily),REGEOCODE(regeocode,逆地理編碼,quota.regeocodeDaily),POI(poi,POI搜索,quota.poiDaily),PING(ping,連通測試,quota.pingDaily);// code/label/configKey 構(gòu)造器 getter}0代表不限負(fù)數(shù)不進(jìn)配置。Redis Hash 按租戶:廠商:自然日建 key凌晨自然過期key 統(tǒng)一加 TTL 防止長尾堆積。踩坑換了廠商坐標(biāo)系也跟著換了有段時間 POI 搜索結(jié)果在小程序地圖上整體偏了 200 米排查了兩天?，F(xiàn)象H5 端搜索南康家具城落地 marker 跟實際位置差一條街。排查過程先懷疑是緩存清了沒用再把高德和百度的原始返回打出來對比發(fā)現(xiàn)兩家返回的經(jīng)緯度不一樣而前端拿百度坐標(biāo)直接往高德地圖上畫。定位思路高德返回 GCJ-02百度返回 BD-09兩個坐標(biāo)系差著幾百米前端只改了個 provider 字符串坐標(biāo)卻沒做轉(zhuǎn)換。最終解決SPI 實現(xiàn)里各廠商返回統(tǒng)一坐標(biāo)系百度的客戶端內(nèi)部把 BD-09 轉(zhuǎn)成 GCJ-02 再吐給上層前端永遠(yuǎn)只認(rèn)一種坐標(biāo)。publicclassBaiduMapClientimplementsMapClient{OverridepublicStringprovider(){returnbaidu;}OverridepublicMapGeoResultgeocode(Stringaddress){MapGeoResultrawbaiduRest.geocode(address);// BD-09// 統(tǒng)一轉(zhuǎn)成 GCJ-02上層無感知returnraw.withLngLat(bd09ToGcj02(raw.getLng(),raw.getLat()));}}順帶把連通測試也做了個ping維度配好新廠商先 ping 一下key 對不對、網(wǎng)絡(luò)通不通一次驗完。接新廠商的完整動作有人問注冊表這么好接一家新的要幾步就三步// 1. 實現(xiàn) SPI 接口provider() 返回唯一標(biāo)識publicclassMapboxMapClientimplementsMapClient{OverridepublicStringprovider(){returnmapbox;}// geocode / searchPoi / ping 各自實現(xiàn)}第二配置文件里加mapbox.key和配額項quota.geocodeDaily等后臺saveChannel接口順手把新字段透傳。第三把默認(rèn)廠商臨時切到 mapbox跑一遍ping和一條真實geocode確認(rèn)坐標(biāo)、配額都正常再切回原廠商灰度觀察。整個過程不碰任何業(yè)務(wù)代碼這就是注冊表模式的底氣。還有個容易忽略的點注冊表用provider()做 key 時統(tǒng)一小寫配toLowerCase(Locale.ROOT)別用默認(rèn) locale——土耳其語環(huán)境里TENCENT.toLowerCase()會帶點變成tenc ent這種鬼樣子線上必翻車。可以直接抄走的清單接口隔離業(yè)務(wù)只依賴MapClient門面廠商是實現(xiàn)細(xì)節(jié)。注冊表收集List構(gòu)造器注入 provider()做 key新增廠商零改動。配置驅(qū)動開關(guān)、默認(rèn)廠商、各廠 key 進(jìn)配置中心切換不發(fā)布。額度前置消費Redis Hashincrement占用、超限回滾拋異常0表示不限。坐標(biāo)統(tǒng)一各廠商實現(xiàn)內(nèi)部做坐標(biāo)系歸一前端永遠(yuǎn)只處理一種坐標(biāo)。維度枚舉化新增計量維度只加枚舉值不散落字符串 key。項目源碼https://gitee.com/gzqkl/qkl-boot