我花3小時(shí)用Java地址解析庫改造訂單系統(tǒng)收貨地址識(shí)別從此告別正則硬扛【免費(fèi)下載鏈接】address-parseJava 版智能解析收貨地址項(xiàng)目地址: https://gitcode.com/gh_mirrors/addr/address-parse晚上十一點(diǎn)我盯著屏幕上第三十二行亂成一團(tuán)的訂單數(shù)據(jù)發(fā)呆張偉13900001111深圳市南山區(qū)科技園xx棟姓名、電話、地址像三股攪在一起的毛線?？头豪镞€在問為什么用戶寫的是南山區(qū)快遞卻差點(diǎn)發(fā)去了黑龍江鶴崗。那一晚我決定不再和正則死磕開始找現(xiàn)成的地址解析方案。如果你也做過電商、物流或外賣后端多半見過同款場(chǎng)面。address-parse 是一個(gè)開源的 Java 版智能解析收貨地址庫核心能力就是地址解析——把混沌文本里的姓名、手機(jī)號(hào)、省市區(qū)、詳細(xì)地址自動(dòng)拆開。這篇是我從評(píng)估到接入的完整記錄末尾附了幾條實(shí)測(cè)踩坑提醒。三個(gè)癥狀說明手寫正則撐不住了先說結(jié)論不是正則不夠快而是它處理不了歧義和殘缺。格式不統(tǒng)一。有人把姓名放最后有人把電話插在中間還有人帶收貨人聯(lián)系電話所在地區(qū)這類前綴甚至混著座機(jī)和郵編。區(qū)名到處重名。南山區(qū)深圳有、鶴崗也有東海連云港有、上海也有。不做區(qū)劃樹回溯正則根本無從判斷。信息不全也要能補(bǔ)。只寫鹽田區(qū)山海四季城F棟17A沒寫省市用戶地址照樣要能識(shí)別出廣東省深圳市。手寫正則在第一個(gè)問題上還能勉強(qiáng)應(yīng)付后面兩個(gè)基本無解。address-parse 把這四件事打包處理清洗冗余詞 → 正則抽聯(lián)系方式 → 最短詞猜姓名 → 三級(jí)行政區(qū)劃匹配。設(shè)計(jì)拆解地址解析的三段式流水線理解它為什么能扛住亂格式比記住 API 更重要。我讀完源碼后把它的思路拆成了三步。第一步是洗。cleanAddress把換行、制表符、連續(xù)空格歸一再把收貨人詳細(xì)地址聯(lián)系電話這類關(guān)鍵詞整體抹掉最后統(tǒng)一清掉中文標(biāo)點(diǎn)。這一步把帶標(biāo)簽的多行表單變成了干凈的一行文本。第二步是抽。三個(gè)正則依次提取手機(jī)號(hào)支持86-前綴、座機(jī)號(hào)如0755-22107333、郵編6位數(shù)字每抽出一個(gè)就從原串里刪除。這樣后面做區(qū)劃匹配時(shí)不會(huì)被數(shù)字串干擾。第三步是配。項(xiàng)目啟動(dòng)時(shí)加載china-area.json用TreeUtils把扁平的省市區(qū)數(shù)據(jù)構(gòu)造成一棵三級(jí)樹每個(gè)節(jié)點(diǎn)還保留簡稱所以北京深圳這種省略寫法也能命中。匹配分三條路同時(shí)走正向命中省份后在其子節(jié)點(diǎn)里找市和區(qū)逆向直接命中區(qū)再沿著parent指針向上回溯出市和省兜底命中市再向下找區(qū)。三條路的結(jié)果都會(huì)返回每條帶一個(gè)type字段標(biāo)明是 PROVINCE、CITY 還是 AREA 級(jí)別。針對(duì)廣東省惠來縣惠城鎮(zhèn)這類容易誤配到惠州市惠城區(qū)的情況源碼里還專門做了同省糾錯(cuò)。3步完成接入clone、裝依賴、調(diào)一個(gè)方法第一步拉代碼。項(xiàng)目依賴 Maven 管理倉庫里有現(xiàn)成的pom.xml。git clone https://gitcode.com/gh_mirrors/addr/address-parse克隆下來后先本地安裝一次它目前以源碼方式對(duì)外提供裝完就能當(dāng)普通依賴用。第二步加依賴。dependency groupIdcom.neo.address.parse/groupId artifactIdaddress-parse/artifactId version1.0-SNAPSHOT/version /dependency這段配置聲明了坐標(biāo)編譯時(shí) Maven 會(huì)從本地倉庫把 jar 拉進(jìn)你的工程。第三步一行調(diào)用。ListParseResult results AddressParse.parse(太陽鮮鮮 鹽田區(qū)山海四季城F棟17A13111111111);注意返回的是List而不是單個(gè)對(duì)象——同一條地址可能被正向和逆向同時(shí)命中你需要自己選一個(gè)最合適的選型技巧見下文避坑清單。拿到結(jié)果后直接讀字段即可字段含義示例name收貨人姓名太陽鮮鮮mobile / phone手機(jī)號(hào) / 座機(jī)號(hào)13111111111province / city / area省 / 市 / 區(qū)廣東省 / 深圳市 / 鹽田區(qū)detail剩余詳細(xì)地址山海四季城F棟17AzipCode郵編518000兩個(gè)真實(shí)場(chǎng)景批量清洗與實(shí)時(shí)預(yù)填場(chǎng)景一清洗歷史訂單地址。問題是要把數(shù)據(jù)庫里幾萬條舊訂單的亂地址規(guī)整成結(jié)構(gòu)化字段。解決方式是并行流批量處理ListString raw loadFromDb(); raw.parallelStream() .map(AddressParse::parse) .flatMap(List::stream) .filter(r - StringUtils.isNotBlank(r.getMobile())) .forEach(this::saveToDb);這段代碼把每條原始地址交給解析器再把結(jié)果攤平過濾后寫回庫。效果方面官方測(cè)試用 45 條典型臟數(shù)據(jù)含多行表單、座機(jī)、86 前綴、重名區(qū)等整體解析耗時(shí)約 112ms單條平均不到 3ms首次類加載的初始化約 440ms之后就是純內(nèi)存匹配。場(chǎng)景二用戶下單時(shí)的智能預(yù)填。問題是想讓老用戶復(fù)制粘貼地址后自動(dòng)拆好省市區(qū)省去手選三級(jí)下拉。解決方式是把parse返回的 AREA 級(jí)結(jié)果回填到表單同時(shí)把detail填進(jìn)門牌號(hào)輸入框。用戶只需核對(duì)一眼即可提交訂單錄入時(shí)間能明顯縮短。5條避坑提醒從多結(jié)果選型到重名串省這些坑我都是實(shí)際踩過才明白的提前寫給你。返回多個(gè)結(jié)果要自己選型。優(yōu)先取type AREA的結(jié)果精確到區(qū)縣沒有再看 CITY、PROVINCE。直接取第一個(gè)可能拿到的只是省級(jí)粗結(jié)果。省略省市時(shí)可能串省。只寫南山區(qū)這類地址匹配器可能命中鶴崗的南山區(qū)。所以存庫時(shí)盡量保留用戶提交的原始串解析結(jié)果只作參考字段。初始化有一次性耗時(shí)。靜態(tài)塊加載區(qū)劃數(shù)據(jù)要幾百毫秒建議應(yīng)用啟動(dòng)后預(yù)熱調(diào)用一次別讓線上首個(gè)請(qǐng)求去承擔(dān)這段開銷。姓名是啟發(fā)式猜測(cè)。它取空格分詞里漢字權(quán)重最短的詞當(dāng)姓名遇到超長人名或極短地址可能判斷互換。用于導(dǎo)出、人工復(fù)核沒問題全自動(dòng)下單要謹(jǐn)慎。直轄市的縣級(jí)單位特殊。測(cè)試數(shù)據(jù)里重慶市 墊江縣會(huì)被歸到直轄縣這個(gè)特殊節(jié)點(diǎn)下字段含義和普通省有差異展示時(shí)要兼容處理。選型對(duì)比什么時(shí)候該用、什么時(shí)候換方案一句話總結(jié)適用邊界要本地化、免費(fèi)用、低延遲選它要精確到鄉(xiāng)鎮(zhèn)村、要地圖坐標(biāo)、要 100% 準(zhǔn)確率另找方案。它目前對(duì)省市區(qū)三級(jí)的覆蓋是完整的但街道、村鎮(zhèn)層級(jí)沒有完整展開也不是地理編碼工具。維度address-parse手寫正則第三方地址 API準(zhǔn)確性高內(nèi)置區(qū)劃庫低重名難處理高性能毫秒級(jí)、純本地快但功能有限受網(wǎng)絡(luò)延遲成本免費(fèi)開源維護(hù)成本高按量付費(fèi)數(shù)據(jù)安全本地處理本地地址明文出網(wǎng)接入難度低高中下一步跑一遍測(cè)試樣例讀懂三段匹配代碼想親手驗(yàn)證它靠不靠譜只需三步克隆倉庫git clone https://gitcode.com/gh_mirrors/addr/address-parse直接運(yùn)行測(cè)試類src/test/java/com/neo/address/parse/AddressParseTest.java的main方法45 條臟數(shù)據(jù)一次看全輸出格式見 README想深入了解機(jī)制讀src/main/java/com/neo/address/parse/AddressParse.java里的parseByProvince、parseByCity、parseByArea三個(gè)方法想看區(qū)劃數(shù)據(jù)長什么樣翻src/main/resources/address-parse/china-area.json。地址解析這活兒不性感但要不要自己造輪子答案其實(shí)很明確先花一個(gè)晚上試這個(gè)庫再?zèng)Q定要不要繼續(xù)手寫正則。大多數(shù)時(shí)候你會(huì)發(fā)現(xiàn)不用了?！久赓M(fèi)下載鏈接】address-parseJava 版智能解析收貨地址項(xiàng)目地址: https://gitcode.com/gh_mirrors/addr/address-parse創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考