做旅游類項目最怕的就是系統(tǒng)做出來像個“景點列表”用戶打開看一眼就關(guān)掉。真正能留住人的是“推薦”兩個字——用戶沒搜過“小眾秘境”系統(tǒng)卻知道他可能喜歡用戶沒查“親子游”首頁卻推了三條適合帶娃的路線。這篇就聊聊我基于 Spring Boot 搭建旅游景點推薦管理系統(tǒng)時的完整設(shè)計思路和實現(xiàn)細節(jié)覆蓋推薦算法選型、數(shù)據(jù)庫設(shè)計、接口規(guī)范、排序策略以及我實際開發(fā)中踩過的那些坑。這個系統(tǒng)適合正在做畢設(shè)、剛接觸推薦場景的開發(fā)者也適合想從“CRUD 管理系統(tǒng)”往“帶算法邏輯的業(yè)務(wù)系統(tǒng)”進階的朋友。整體技術(shù)棧是 Spring Boot 3 MyBatis-Plus Redis MySQL推薦部分沒有盲目上大數(shù)據(jù)框架而是用了加權(quán)混合策略——基于用戶行為的協(xié)同過濾做主推基于景點標簽的內(nèi)容推薦做兜底再用熱門度和新鮮度做動態(tài)干預(yù)。1. 項目整體設(shè)計與技術(shù)選型拆解1.1 為什么用 Spring Boot 而不是 SSM 或微服務(wù)說實話這種體量的項目用微服務(wù)就是給自己找麻煩。景點推薦系統(tǒng)核心鏈路是“用戶 → 行為采集 → 推薦計算 → 結(jié)果輸出”單機 Spring Boot 完全扛得住而且開發(fā)效率高。Spring Boot 最值錢的不是那些自動配置而是它讓你把精力集中在業(yè)務(wù)邏輯上——你不需要關(guān)心 Tomcat 怎么配、MyBatis 怎么整合、JSON 序列化怎么開啟這些框架級的東西 Spring Boot 都處理好了。我選 Spring Boot 3 還有一個原因JDK 17 的record類型對 DTO 太友好了配合MapStruct做對象轉(zhuǎn)換代碼量直接砍掉三分之一。如果你還在用 JDK 8Spring Boot 2.x 也完全夠用核心邏輯不受影響。1.2 整體功能模塊劃分這套系統(tǒng)按角色分為游客端和管理端功能上不追求大而全而是圍繞“推薦”這個核心鏈路設(shè)計游客端首頁個性化推薦流按用戶行為動態(tài)排序景點搜索與多條件篩選區(qū)域、主題、評分、價格區(qū)間景點詳情頁基本信息、圖片集、評論、相似推薦收藏/點贊/評分/瀏覽行為采集歷史足跡與偏好管理管理端景點信息管理新增、上下架、標簽維護區(qū)域與分類管理省市區(qū)三級聯(lián)動評論審核與敏感詞過濾用戶管理狀態(tài)封禁、角色分配推薦策略配置權(quán)重參數(shù)在線調(diào)整1.3 推薦鏈路的整體設(shè)計推薦系統(tǒng)最核心的是數(shù)據(jù)流。在這個項目里我把鏈路設(shè)計成下面四條線線1行為采集 → 用戶行為表瀏覽、收藏、評分、點評 線2離線計算 → 每晚跑一次協(xié)同過濾生成用戶相似度矩陣和候選集 線3在線干預(yù) → 用戶在訪問時觸發(fā)實時規(guī)則地域優(yōu)先、熱度加權(quán)、新品加權(quán) 線4結(jié)果融合 → 多路召回結(jié)果合并 → 規(guī)則過濾 → 排序輸出這里面有個容易被新手忽略的點協(xié)同過濾的候選集不能直接作為最終結(jié)果返回。因為它是離線算好的沒辦法感知“今天有新的爆款景點上線”或者“用戶此刻搜索了某個區(qū)域”。所以必須有一層在線干預(yù)邏輯把實時信號疊加上去。2. 推薦算法選型與落地實現(xiàn)2.1 基于協(xié)同過濾的推薦邏輯這套系統(tǒng)的冷啟動難點在于新用戶沒有行為數(shù)據(jù)新景點沒有評分記錄。我采用了“基于用戶的協(xié)同過濾UserCF 基于物品的協(xié)同過濾ItemCF”雙軌方案用戶量小、行為稀疏時走 UserCF找相似用戶喜歡的景點景點數(shù)量變動頻繁時走 ItemCF因為用戶對景點的偏好不容易漂移。具體實現(xiàn)上UserCF 的相似度計算我用的是余弦相似度。假設(shè)用戶A對景點的評分為稀疏向量用戶B同理計算兩者的夾角余弦public double cosineSimilarity(MapLong, Double userVec1, MapLong, Double userVec2) { SetLong commonItems new HashSet(userVec1.keySet()); commonItems.retainAll(userVec2.keySet()); if (commonItems.isEmpty()) return 0.0; double dot 0.0, norm1 0.0, norm2 0.0; for (Long itemId : commonItems) { dot userVec1.get(itemId) * userVec2.get(itemId); } for (double v : userVec1.values()) norm1 v * v; for (double v : userVec2.values()) norm2 v * v; if (norm1 0 || norm2 0) return 0.0; return dot / (Math.sqrt(norm1) * Math.sqrt(norm2)); }相似度矩陣離線計算完成后存入 Redis用user:{id}:sim的 key 存儲 topN 相似用戶。為什么不用 MySQL 存因為相似度矩陣是MxM級別的稠密數(shù)據(jù)用戶量到一萬關(guān)系數(shù)量就是億級MySQL 撐不住Redis 的zset天然適合存“用戶 → 相似用戶 相似度分值”這種結(jié)構(gòu)。2.2 基于內(nèi)容和標簽的兜底推薦協(xié)同過濾有個致命弱點新景區(qū)完全沒有行為數(shù)據(jù)永遠不會被推薦。所以我的策略里必須有基于內(nèi)容的推薦做兜底。我在景點表設(shè)計了三個標簽字段theme主題類別如“自然風光”“人文歷史”“親子游樂”region_level區(qū)域標簽如“市區(qū)必打卡”“郊區(qū)徒步”crowd_type適合人群如“情侶游”“親子游”“獨自旅行”?；趦?nèi)容推薦的核心邏輯就是用戶對某個景點產(chǎn)生正向行為收藏/評分 ≥ 4后系統(tǒng)提取該景點的標簽再找同一標簽體系下用戶未見過的其他景點。public ListScenicSpot recommendByTags(Long userId, int limit) { // 1. 找出用戶行為表中評分4的景點標簽 ListScenicTag positiveTags getPositiveTags(userId); // 2. 統(tǒng)計標簽權(quán)重權(quán)重 該標簽對應(yīng)景點數(shù)量占比 MapString, Double tagWeights weightedTags(positiveTags); // 3. 按權(quán)重分數(shù)召回候選景點排除用戶已見過的 return candidateFilter(userId, tagWeights, limit); }這個方案實現(xiàn)簡單但能保證“新用戶、新景點”這倆極端場景都有內(nèi)容可推。實操中我建議把標簽控制在每個景點 3~5 個太多會稀釋相似度計算的準確性。2.3 熱度加權(quán)與“新鮮度懲罰”推薦系統(tǒng)做久了就會發(fā)現(xiàn)純推薦算法容易讓推薦列表變得非?！坝病薄肋h推那幾類熱門景點用戶很快就會審美疲勞。我在推薦排序時加了兩個動態(tài)調(diào)節(jié)因子熱度衰減因子景點總瀏覽量、近7天搜索量、收藏增量按時間窗口滑動計算保證長江大橋這種老牌景點不會因為歷史瀏覽量高就永遠霸榜新景點加權(quán)景點上架時間在30天內(nèi)排序時增加20%的權(quán)重讓新景點有機會曝光。熱度分的計算公式我簡化成了public double heatScore(ScenicSpot spot, int dayRange) { long viewCount statisticMapper.queryViewCount(spot.getId(), dayRange); long favCount statisticMapper.queryFavoriteCount(spot.getId(), dayRange); double ageScore spot.getDaysSinceCreated() 30 ? 1.0 : 1.2; return (viewCount * 0.4 favCount * 1.2) * ageScore; }收藏的權(quán)重比瀏覽量高因為收藏代表用戶的意圖更強瀏覽量可能是誤點或被動刷到。2.4 推薦結(jié)果的融合排序策略多路召回之后就是排序融合。我的融合策略是加權(quán)線性組合權(quán)重參數(shù)全部做成了數(shù)據(jù)庫配置管理員后臺可以實時調(diào)整召回來源權(quán)重占比排序因子協(xié)同過濾用戶相似40%相似用戶對該景點的平均評分內(nèi)容/標簽匹配30%標簽重合度熱度干預(yù)20%heatScore歸一化值區(qū)域匹配在線干預(yù)10%用戶常駐區(qū)域與景點區(qū)域是否匹配融合公式double finalScore 0.4 * simScore 0.3 * tagScore 0.2 * heatScore 0.1 * regionScore;為什么把協(xié)同過濾權(quán)重放最大因為在所有召回信號里相似用戶的行為是最有說服力的——它能捕捉到“標簽無法表達”的偏好比如“喜歡人文類景點的人往往也喜歡老建筑改造的咖啡館”這種隱性關(guān)聯(lián)標簽體系根本無法表達。但注意權(quán)重是需要調(diào)參的。實操中我給管理后臺做了 A/B 測試接口管理員可以配置不同的權(quán)重組合系統(tǒng)按用戶ID哈希分流展示不同版本用點擊率和收藏轉(zhuǎn)化率作為衡量指標。這個細節(jié)在畢設(shè)論文或項目文檔里寫出來非常有亮點。3. 核心功能模塊的設(shè)計與實現(xiàn)3.1 數(shù)據(jù)庫模型設(shè)計數(shù)據(jù)庫設(shè)計我踩過最大的坑就是一開始把景點信息做成了一張大表結(jié)果后面加標簽、加區(qū)域等級、加圖片集的時候天天在改表結(jié)構(gòu)。后來我重構(gòu)成了標準的三層結(jié)構(gòu)scenic_spot景點主表ID、名稱、簡介、介紹、區(qū)域ID、評分、狀態(tài)、創(chuàng)建時間 scenic_tag標簽表ID、標簽名、類型主題/人群/區(qū)域等級 scenic_spot_tag景點—標簽關(guān)聯(lián)表景點ID、標簽ID景點圖片則用一張獨立的scenic_image表一個景點可以有多張圖。為什么獨立成表因為列表頁只需要封面圖詳情頁需要完整圖集如果都塞在 JSON 字段里列表查詢性能會很難看。核心表結(jié)構(gòu)參考CREATE TABLE scenic_spot ( id BIGINT PRIMARY KEY AUTO_INCREMENT, name VARCHAR(100) NOT NULL, summary VARCHAR(500) COMMENT 一句話簡介, detail TEXT COMMENT 詳細介紹, region_code VARCHAR(20) COMMENT 區(qū)域編碼省市區(qū), cover_image VARCHAR(255), avg_score DECIMAL(2,1) DEFAULT 0.0, status TINYINT DEFAULT 1 COMMENT 1上架 0下架, online_time DATETIME COMMENT 上架時間用于新景點加權(quán), created_at DATETIME DEFAULT CURRENT_TIMESTAMP ); CREATE TABLE scenic_spot_tag ( id BIGINT PRIMARY KEY AUTO_INCREMENT, scenic_id BIGINT NOT NULL, tag_id BIGINT NOT NULL, tag_type VARCHAR(20) COMMENT theme/crowd/region, UNIQUE KEY uk_scenic_tag (scenic_id, tag_id) ); CREATE TABLE user_behavior ( id BIGINT PRIMARY KEY AUTO_INCREMENT, user_id BIGINT NOT NULL, scenic_id BIGINT NOT NULL, behavior_type VARCHAR(20) COMMENT view/favorite/rating/comment, rating_score TINYINT COMMENT 1-5分僅rating行為有值, created_at DATETIME DEFAULT CURRENT_TIMESTAMP, KEY idx_user_behavior (user_id, behavior_type) );user_behavior是推薦系統(tǒng)的“油田”所有行為數(shù)據(jù)必須落表而且一定要加索引。我在測試環(huán)境里模擬了10萬條行為數(shù)據(jù)如果沒有(user_id, behavior_type)聯(lián)合索引查詢耗時直接沖到2秒以上加了索引后穩(wěn)定在 50ms 以內(nèi)。3.2 個性化推薦接口的實現(xiàn)細節(jié)推薦接口是系統(tǒng)的核心我設(shè)計成GetMapping(/api/recommend) public ResultListScenicVO recommend( RequestParam Long userId, RequestParam(defaultValue 1) int page, RequestParam(defaultValue 10) int size) { // 1. 多路召回 ListRecommendItem cfItems recallByCollaborativeFiltering(userId, 30); ListRecommendItem contentItems recallByContentMatch(userId, 20); ListRecommendItem hotItems recallByHeatScore(userId, 10); // 2. 合并去重 MapLong, RecommendItem merged mergeItems(cfItems, contentItems, hotItems); // 3. 規(guī)則過濾下架景點、用戶已收藏且明確不想看的 merged ruleFilter(userId, merged); // 4. 融合打分 排序 分頁 ListScenicVO result rankAndPage(merged, page, size); return Result.success(result); }這里有個關(guān)鍵細節(jié)召回量必須大于最終展示量。如果頁面上要展示10個那協(xié)同過濾至少要召回30個候選再往后排。因為融合打分后總會有一些“雖然相似度分高但熱度太低”的景點被淘汰掉召回不足會導致列表末尾湊不滿。分頁的邏輯和普通列表不同。推薦流的分頁不建議用頁碼深翻頁而在實際項目中使用offset深翻頁性能會急劇下降。推薦流更合理的做法是游標分頁用上次返回列表最后一個景點的最終得分作為score_after下次查詢只取分數(shù)小于該值的記錄。這樣用戶往下翻時推薦流整體不回退體驗上更像刷信息流而不是查列表。3.3 管理端景點推薦權(quán)重配置管理端除了常見的CRUD我額外加了“推薦策略配置”頁面。管理員可以實時調(diào)整協(xié)同過濾權(quán)重40% 內(nèi)容匹配權(quán)重30% 熱度干預(yù)權(quán)重20% 區(qū)域匹配權(quán)重10% 新景點加權(quán)天數(shù)30 新景點加權(quán)分值1.2這些參數(shù)我設(shè)計成存在一張recommend_config表里Redis 緩存5分鐘自動刷新。為什么要動態(tài)配置因為推薦系統(tǒng)的調(diào)優(yōu)是一個長期過程尤其是在前期數(shù)據(jù)量少的時候協(xié)同過濾的效果可能不如熱度推薦這時候就要把熱度權(quán)重調(diào)高等用戶行為積累多了再慢慢加大協(xié)同過濾的占比。3.4 用戶行為上報接口的防抖設(shè)計行為采集接口很容易被反復調(diào)用——用戶滑過同一個景點三次前端可能上報三次瀏覽記錄。如果每次都落表行為數(shù)據(jù)就會出現(xiàn)大量噪聲影響推薦準確性。我的做法是在接口層做了一層簡單的防抖public void recordBehavior(Long userId, Long scenicId, String type) { // 瀏覽行為30秒內(nèi)只記一次 if (view.equals(type)) { String redisKey view:debounce: userId : scenicId; Boolean firstTime redisTemplate.opsForValue().setIfAbsent(redisKey, 1, Duration.ofSeconds(30)); if (Boolean.FALSE.equals(firstTime)) return; } // 收藏/評分屬于強意圖行為不防抖每次都記錄 behaviorMapper.insert(...); }這個細節(jié)看起來小但直接影響推薦質(zhì)量。如果用戶只是刷了幾個景點詳情頁系統(tǒng)就以為他“喜歡”這幾個景點協(xié)同過濾算出來的相似用戶就會偏得離譜。4. 推薦系統(tǒng)中的關(guān)鍵問題排查與解決記錄4.1 冷啟動問題的落地解法新用戶第一次進系統(tǒng)時行為表里什么數(shù)據(jù)都沒有協(xié)同過濾和內(nèi)容推薦都成了無源之水。我按下面優(yōu)先級給冷啟動用戶設(shè)計了一套策略用戶注冊時選擇偏好標簽必選至少3個直接作為內(nèi)容推薦的種子用 IP 定位城市優(yōu)先推薦用戶所在城市及周邊“必打卡”景點仍未捕獲信號時用全局熱度榜 新景點加權(quán)填充首頁。第1條最關(guān)鍵。注冊引導里讓用戶選“自然風光/人文歷史/美食探店/城市夜景”多選標簽一是作為推薦的種子數(shù)據(jù)二是方便后續(xù)算法校驗。4.2 相似度計算性能優(yōu)化我第一次跑 UserCF 的用戶相似度計算邏輯是用戶兩兩之間全量比對用戶數(shù)3000時跑了30多秒。后來我做了兩步優(yōu)化UserCF 預(yù)篩先按“共同評分過的景點數(shù)量”粗篩共同景點數(shù)低于3的直接跳過計算節(jié)省80%無效計算向量化計算只對行為矩陣的非零項做迭代避免遍歷全表。優(yōu)化后3000用戶的相似度矩陣計算降到3秒左右。如果用戶量再上臺階就該考慮用 Spark 或 Flink 做了但中等體量下數(shù)據(jù)庫內(nèi)解決完全足夠。4.3 推薦的“驚度”問題相似度過高上線后遇到一個很典型的反饋推薦列表連續(xù)5個景點都是“同質(zhì)化古鎮(zhèn)”雖然用戶確實喜歡古鎮(zhèn)但一眼掃過去全是同一類型體驗非常差。我在排序階段加了一個MMR最大邊際相關(guān)性去重策略public ListScenicVO diversityRank(ListRecommendItem candidates, int limit) { ListRecommendItem result new ArrayList(); // 候選先按分數(shù)降序 candidates.sort(Comparator.comparingDouble(RecommendItem::getScore).reversed()); result.add(candidates.get(0)); SetLong selectedTags new HashSet(candidates.get(0).getTagIds()); for (int i 1; i candidates.size() result.size() limit; i) { RecommendItem item candidates.get(i); SetLong tags new HashSet(item.getTagIds()); // 計算與已選結(jié)果的重合度 long overlap tags.stream().filter(selectedTags::contains).count(); double adjustedScore item.getScore() - overlap * 0.25; // 動態(tài)插到已排序結(jié)果中 ... } return result; }實際效果就是推薦列表里每隔幾個景點就會穿插不同類型的景觀不至于讓人產(chǎn)生“我是不是被某一種內(nèi)容包圍了”的感覺。4.4 性能瓶頸推薦接口慢查詢排查聯(lián)調(diào)測試時發(fā)現(xiàn)推薦接口從點擊到數(shù)據(jù)返回到達 1.8 秒明顯太慢。日志定位后發(fā)現(xiàn)慢在查詢用戶行為這一步——每次請求都動態(tài)查詢用戶一年內(nèi)的行為記錄。優(yōu)化的方法是引入行為緩存// 用戶近30天行為摘要緩存 redisTemplate.opsForValue().set(user:profile: userId, JSON.toJSONString(userProfile), Duration.ofMinutes(10));同時把“熱門榜”和“相似用戶 topN 結(jié)果”各緩存5分鐘推薦接口的響應(yīng)時間從 1.8 秒降到了 230ms 左右。這個優(yōu)化路徑很通用推薦系統(tǒng)計算部分可以稍微“陳舊”但不能慢行為數(shù)據(jù)可以稍微延遲但結(jié)果要快。4.5 常見問題速查表場景現(xiàn)象原因解決方案新用戶首頁空白推薦接口返回0條行為表無數(shù)據(jù)導致召回為空冷啟動策略注冊選標簽城市必打卡熱度兜底推薦結(jié)果單一連續(xù)多個同類型景點排序?qū)訜o去重邏輯加MMR多樣性排序按標簽重合度懲罰分數(shù)相似度計算超時后臺任務(wù)跑很久全量用戶兩兩比對預(yù)篩只算非零項向量新景點永遠沒曝光新上架景點無推薦冷啟動且無行為數(shù)據(jù)上架30天加權(quán)1.2熱度分乘系數(shù)行為數(shù)據(jù)噪聲大推薦結(jié)果偏離用戶確實偏好瀏覽行為重復上報加Redis防抖30秒內(nèi)相同瀏覽只記一次管理端改權(quán)重不生效推薦結(jié)果沒變化配置緩存未刷新配置存DBRedis緩存過期時間設(shè)5分鐘5. 經(jīng)驗總結(jié)與項目擴展方向這套旅游景點推薦管理系統(tǒng)真正讓我理解了“推薦不是算法題而是工程題”這句話。算法本身并不神秘協(xié)同過濾教科書里都有公式真正讓一個推薦系統(tǒng)“能用”的關(guān)鍵要素我總結(jié)為三條行為數(shù)據(jù)采集質(zhì)量比算法模型更重要。數(shù)據(jù)臟、上報亂、缺字段后面再牛的算法都白搭冷啟動和多樣性是同樣需要認真對待的功能而不只是調(diào)參細節(jié)。用戶注冊引導、新景點加權(quán)這些“非算法”因素對系統(tǒng)體驗的影響往往超過算法本身推薦結(jié)果必須能解釋。給每個推薦項打上推薦理由——“因為您常看人文歷史類景點”“您的好友經(jīng)常收藏這里”——用戶對推薦的理解度提升了點擊率自然上來了。這一點我在詳情頁推薦位加了一句推薦說明整體點擊率提升了大約11%。這個項目后續(xù)如果繼續(xù)演進有兩個方向我覺得價值很大一是把用戶行為數(shù)據(jù)接入流式計算做到“剛剛搜索完、首頁立刻反映”這屬于實時推薦體系二是加知識圖譜把景區(qū)之間的關(guān)系從標簽升級為“相鄰/同主題/同類人群聚集/歷史背景關(guān)聯(lián)”這種更豐富的語義連接會讓推薦結(jié)果的解釋性更強。如果從零開始復刻這個項目我建議的順序是先搭 Spring Boot 骨架、建好五張核心表再實現(xiàn)行為上報和基礎(chǔ) CRUD推薦算法先做熱度榜把鏈路跑通隨后并行加入?yún)f(xié)同過濾和內(nèi)容召回融合排序和多樣性機制放在最后調(diào)優(yōu)。少數(shù)用戶在算法上磨太久重蹈了我第一版的覆轍——花了兩周寫了一個效果還不如熱度榜的推薦算法把用戶行為分析和數(shù)據(jù)鏈路建設(shè)的時間給擠掉了。最后分享一個經(jīng)驗建議推薦系統(tǒng)的效果衡量不要只看“準確率”要看“用戶在推薦位上的點擊率”和“收藏轉(zhuǎn)化率”。準確率高可能只是因為你推薦的都是熱門景點用戶不反感罷了。真正能驗證推薦價值的是用戶點了一個他原來根本不會主動搜的景點并且產(chǎn)生了正向反饋——那時候你才可以說這套推薦系統(tǒng)是真正在起作用。