1. 項(xiàng)目概述與受眾先聊聊這套 Java Spring Boot 基于 Android 的房屋租賃系統(tǒng)。很多人一聽(tīng)這名字第一反應(yīng)是 又一個(gè)畢設(shè)項(xiàng)目但實(shí)際把它拆開(kāi)看它就是一套典型的移動(dòng)端 服務(wù)端兩層結(jié)構(gòu)Android 負(fù)責(zé)給租客、房東、管理員提供操作界面Spring Boot 負(fù)責(zé)提供房源數(shù)據(jù)的增刪改查、用戶(hù)登錄、租賃訂單管理等所有后端能力。市面上大量房屋租賃平臺(tái)比如鏈家、自如的 App核心流程也是這套邏輯瀏覽房源、預(yù)約看房、下單簽約、管理房源狀態(tài)區(qū)別只是業(yè)務(wù)復(fù)雜度和 UI 精致度。所以這個(gè)項(xiàng)目學(xué)通了不只是能過(guò)答辯而是能理解一個(gè)真實(shí)業(yè)務(wù)系統(tǒng)從數(shù)據(jù)庫(kù)到接口再到 App 界面的完整鏈路。這個(gè)系統(tǒng)能解決什么問(wèn)題最直白地講它把在線下中介門(mén)店或者社區(qū)公告欄里貼房源信息、打電話約看房的場(chǎng)景搬到了手機(jī)端。房東在 App 里錄入房源、傳圖片、設(shè)置租金租客按區(qū)域、戶(hù)型、租金區(qū)間篩選房源看到合適的可以直接收藏或發(fā)起預(yù)約管理員在后端接口的幫助下做房源審核、用戶(hù)管理、數(shù)據(jù)統(tǒng)計(jì)。用技術(shù)來(lái)替代人工撮合和信息登記這就是項(xiàng)目存在的意義。適合什么人參考如果你是做 Java 后端開(kāi)發(fā)想看看 Spring Boot 接口設(shè)計(jì)、權(quán)限認(rèn)證、文件上傳怎么在一個(gè)真實(shí)項(xiàng)目里落地如果你是學(xué) Android 的想知道一個(gè)完整 App 怎么組織頁(yè)面、怎么封裝網(wǎng)絡(luò)請(qǐng)求、怎么和后臺(tái)聯(lián)調(diào)如果你是畢設(shè)或者課程設(shè)計(jì)需要一套能講清楚、能跑得起來(lái)的系統(tǒng)那這個(gè)項(xiàng)目都值得花時(shí)間拆一遍。我這個(gè)分享不會(huì)只停留在 下載源碼、啟動(dòng)運(yùn)行 的層面而是把里面的技術(shù)點(diǎn)、設(shè)計(jì)取舍、常見(jiàn)坑位全部講透看完之后你能對(duì)這套系統(tǒng) 不僅會(huì)跑還知道為什么這樣寫(xiě)。2. 技術(shù)選型與架構(gòu)思路2.1 為什么選擇 Spring Boot Android先說(shuō)服務(wù)端。Spring Boot 在這個(gè)項(xiàng)目里的地位幾乎是不可替代的。相對(duì)傳統(tǒng) SSM 框架Spring Boot 內(nèi)置 Tomcat省掉大量 XML 配置利用自動(dòng)裝配讓開(kāi)發(fā)者專(zhuān)注寫(xiě)業(yè)務(wù)代碼。即便是剛從 Java Web 基礎(chǔ)轉(zhuǎn)過(guò)來(lái)的學(xué)生也能在一兩小時(shí)內(nèi)把它跑起來(lái)。如果選 PHP 或 Node.js當(dāng)然也能做租賃系統(tǒng)但在 Java 技術(shù)棧的分子里Spring Boot 是面試、畢設(shè)、小公司外包項(xiàng)目中出場(chǎng)率最高的學(xué)一遍的性?xún)r(jià)比極高。Android 客戶(hù)端為什么不用 Web 頁(yè)面替代因?yàn)轫?xiàng)目的定位是 移動(dòng)端房屋租賃并且 Android 原生能調(diào)用相冊(cè)選圖、推送本地通知、保持登錄狀態(tài)等能力比 H5 頁(yè)面體驗(yàn)更接近真實(shí)產(chǎn)品。在實(shí)際開(kāi)發(fā)中很多團(tuán)隊(duì)為了省事會(huì)把 Android 換成 Vue 做后臺(tái)管理頁(yè)面再套一層 WebView但這樣一來(lái)你失去了原生 App 的完整開(kāi)發(fā)鏈路——OkHttp 網(wǎng)絡(luò)請(qǐng)求、RecyclerView 列表復(fù)用、圖片框架加載這些都是 Android 面試和工作中非常常用的點(diǎn)。這個(gè)項(xiàng)目選擇原生 Android走的是更正統(tǒng)且更耐看的路線。2.2 前后端職責(zé)劃分與交互流程這套系統(tǒng)的架構(gòu)并不復(fù)雜但我建議學(xué)習(xí)的時(shí)候把它想象成 一個(gè)前臺(tái) App 一個(gè)后臺(tái)服務(wù)。后端 Spring Boot 不負(fù)責(zé)渲染任何頁(yè)面而是暴露一套 RESTful API統(tǒng)一返回 JSON 數(shù)據(jù)。Android 端通過(guò) HTTP 請(qǐng)求訪問(wèn)這些接口拿到 JSON 后解析成 JavaBean渲染到界面。這樣前后端完全是解耦的后期想換一個(gè)客戶(hù)端比如再加一個(gè) iOS 端后端代碼一行都不用動(dòng)。典型的一次 房東發(fā)布房源 流程是這樣的Android 端登錄保存 Token 到本地。房東在發(fā)布頁(yè)面填寫(xiě)房源的標(biāo)題、戶(hù)型、面積、租金、地址、描述并選擇多張圖片。Android 端把圖片通過(guò) OkHttp 以 multipart/form-data 方式上傳到 Spring Boot 的文件上傳接口。接口返回圖片 URL 后Android 端再連同房源文本字段一起提交到/house/add接口。Spring Boot 收到請(qǐng)求后先校驗(yàn) Token 權(quán)限再校驗(yàn)參數(shù)完整性最后向 MySQL 中插入房源記錄。這個(gè)過(guò)程中客戶(hù)端只做 展示和收集服務(wù)端做 校驗(yàn)和落庫(kù)雙方通過(guò) JSON 定好數(shù)據(jù)結(jié)構(gòu)。理解了這個(gè)分界線后面看代碼、改功能才有方向感。2.3 基礎(chǔ)設(shè)施與目錄結(jié)構(gòu)我用一個(gè)表格把項(xiàng)目推薦的技術(shù)棧和版本整理出來(lái)這套組合比較穩(wěn)不容易出現(xiàn)環(huán)境沖突層級(jí)技術(shù)選型備注服務(wù)端框架Spring Boot 2.7.x兼容性最好JDK 8/11 都能用ORMMyBatis-Plus租戶(hù)隔離、分頁(yè)插件、CRUD 代碼生成器很實(shí)用數(shù)據(jù)庫(kù)MySQL 5.7 / 8.0推薦 5.7多數(shù)畢設(shè)環(huán)境已預(yù)裝認(rèn)證方案JWTjsonwebtoken 0.9.1無(wú)狀態(tài)Android 端存入本地Android 網(wǎng)絡(luò)OkHttp 4.x Gson簡(jiǎn)潔直接便于理解請(qǐng)求流程Android 圖片Glide 4.x圖片加載緩存統(tǒng)一處理圖片存儲(chǔ)本地磁盤(pán)路徑 靜態(tài)資源映射簡(jiǎn)單易部署無(wú)需引入第三方 OSS在源碼結(jié)構(gòu)上后端通常按照controller / service / mapper / entity / common / config分包。Android 端則是activity / adapter / bean / api / utils / fragment分層。這種分法不花哨但勝在清晰。實(shí)際接手項(xiàng)目時(shí)我第一件事就是把包結(jié)構(gòu)看一遍因?yàn)榘Y(jié)構(gòu)能直接反映這個(gè)項(xiàng)目寫(xiě)沒(méi)寫(xiě) 人樣。3. 數(shù)據(jù)庫(kù)設(shè)計(jì)與核心表結(jié)構(gòu)3.1 用戶(hù)、房源、訂單、收藏表設(shè)計(jì)數(shù)據(jù)庫(kù)設(shè)計(jì)是決定系統(tǒng)好改難改的關(guān)鍵。很多畢設(shè)項(xiàng)目外觀能跑但新增一個(gè)功能要?jiǎng)恿邚埍砭褪且驗(yàn)楫?dāng)初字段設(shè)計(jì)不合理。這套房屋租賃系統(tǒng)里最核心的是四張表user用戶(hù)house房源housestate租賃訂單/狀態(tài)collect收藏。用戶(hù)表不必多說(shuō)需要區(qū)分管理員和普通用戶(hù)我一般在role字段里用數(shù)字區(qū)分1表示管理員2表示房東3表示租客。有同學(xué)問(wèn)為什么不建三張用戶(hù)表這屬于過(guò)度設(shè)計(jì)。除非業(yè)務(wù)差異大到字段完全不同否則一張表加角色字段就夠了。房源表是信息密度最大的表我列出比較常見(jiàn)的字段設(shè)計(jì)思路你可以直接抄作業(yè)字段名類(lèi)型說(shuō)明idint主鍵user_idint發(fā)布者 IDtitlevarchar(100)房源標(biāo)題typevarchar(20)出租方式整租/合租addressvarchar(255)小區(qū)地址areadouble面積平方米pricedouble月租價(jià)格imagestext圖片 URL多張用逗號(hào)分隔statusint0 待審核 / 1 已上架 / 2 已出租 / 3 已下架create_timedatetime發(fā)布時(shí)間我這里特意把images字段設(shè)計(jì)成逗號(hào)分隔的字符串而不是單獨(dú)建一張圖片表。有人會(huì)爭(zhēng)論這樣做不規(guī)范但在這種小體量系統(tǒng)里這是一種性?xún)r(jià)比極高的方案查詢(xún)列表時(shí)只需查一張表減少一次子查詢(xún)或關(guān)聯(lián)查詢(xún)。如果你追求范式嚴(yán)格也可以拆圖片表但實(shí)際開(kāi)發(fā)和畢設(shè)維護(hù)都會(huì)變麻煩沒(méi)必要。訂單表是整個(gè)業(yè)務(wù)核心它負(fù)責(zé)記錄一次租賃關(guān)系的完整狀態(tài)變化字段一般包括圖片、house_id、user_id、landlord_id、start_time、end_time、rent_month 等尤其是status字段要靈活動(dòng)態(tài)化因?yàn)楹罄m(xù)接口邏輯全靠它判斷。3.2 狀態(tài)字段與關(guān)鍵索引設(shè)計(jì)狀態(tài)字段是最容易被小看的。比如房源狀態(tài)我建議用int而不是字符串原因很簡(jiǎn)單字符串一旦拼寫(xiě)不一致比如 上架 和 上架 直接會(huì)導(dǎo)致列表查不到數(shù)據(jù)數(shù)字枚舉在代碼里寫(xiě)常量或枚舉類(lèi)可讀性一點(diǎn)不差。后續(xù)你寫(xiě) SQL比如 查詢(xún)所有已上架房源就是WHERE status 1清晰高效。訂單表的狀態(tài)流轉(zhuǎn)我習(xí)慣用狀態(tài)機(jī)思維設(shè)計(jì)避免業(yè)務(wù)邏輯到處亂寫(xiě)。比如一次租賃訂單可以經(jīng)歷這些狀態(tài)0待確認(rèn)1已確認(rèn)等待支付/簽約2租賃中3已到期4已取消5已退租這樣一來(lái)每次狀態(tài)變化的判定都集中到service層的一個(gè)方法里不會(huì)出現(xiàn) 在 controller 里偷偷改字段 的爛代碼。索引設(shè)計(jì)也不能只靠默認(rèn)主鍵。在這個(gè)項(xiàng)目里有兩個(gè)查詢(xún)場(chǎng)景頻率最高用戶(hù)查看自己的發(fā)布記錄user_id查詢(xún)、平臺(tái)端按狀態(tài)篩選列表status查詢(xún)。所以我會(huì)在user_id和status上各自加一個(gè)普通索引。數(shù)據(jù)量不大時(shí)可能看不出差別但這是好習(xí)慣也方便你在答辯時(shí)說(shuō)清楚 為什么加索引。4. 后端接口與核心邏輯實(shí)現(xiàn)4.1 登錄認(rèn)證與權(quán)限控制登錄認(rèn)證是后端最重要的一塊。這個(gè)項(xiàng)目常用 JWT 或者 Session我建議優(yōu)先使用 JWT因?yàn)樗菬o(wú)狀態(tài)的Android 端拿到 Token 存本地即可服務(wù)端升級(jí)擴(kuò)容、橫向擴(kuò)展時(shí)沒(méi)有 Session 同步問(wèn)題。我簡(jiǎn)單描述一下 JWT 的接入思路。用戶(hù)調(diào)用/user/login提交用戶(hù)名和密碼后端校驗(yàn)通過(guò)后用 secret key 生成 Token返回給 Android。Token 里可以帶上 userId、role 這些關(guān)鍵信息但千萬(wàn)不要把密碼放進(jìn)去。之后每次 Android 發(fā)起需要身份認(rèn)證的請(qǐng)求都在 header 里攜帶token: xxx。Spring Boot 通過(guò)一個(gè)攔截器或者過(guò)濾器在進(jìn)入 controller 前解析 Token、校驗(yàn)合法性和有效期再把用戶(hù)信息放到 request 里。寫(xiě)攔截器時(shí)有幾個(gè)容易踩的坑不需要認(rèn)證的路徑比如登錄、注冊(cè)、房源列表必須放行否則用戶(hù)沒(méi)登錄就看不到任何內(nèi)容。Token 過(guò)期后要返回統(tǒng)一格式的錯(cuò)誤信息Android 端收到后需要做 重新登錄 的跳轉(zhuǎn)提示而不是讓界面卡在空白頁(yè)面。管理員的接口要校驗(yàn) role 字段防止普通用戶(hù)通過(guò)直接調(diào)用接口刪房源。4.2 租賃流程中的關(guān)鍵接口與狀態(tài)機(jī)圍繞房屋租賃我認(rèn)為最值得學(xué)習(xí)的是兩個(gè)接口添加房源和創(chuàng)建訂單。添加房源接口的流程我前面提過(guò)這里補(bǔ)充一個(gè)關(guān)鍵點(diǎn)圖片上傳接口一定不能和房源新增接口耦合成一個(gè)接口否則圖片較大時(shí)請(qǐng)求超時(shí)概率很高。正確做法是先后端提供一個(gè)/upload返回圖片 URL再把 URL 拼接進(jìn)房源數(shù)據(jù)。這樣一方面提高了重試的靈活性另一方面方便復(fù)用。上傳建議限制圖片大小比如單張最大 5MB格式校驗(yàn)白名單防止用戶(hù)傳非圖片文件進(jìn)來(lái)。創(chuàng)建訂單接口的難點(diǎn)在于并發(fā)和防重復(fù)。業(yè)務(wù)中租客可能手快點(diǎn)了兩次 立即租房如果不做處理會(huì)出現(xiàn)同一房源同時(shí)生成兩筆訂單。處理方法不復(fù)雜在創(chuàng)建訂單前先查詢(xún)?cè)摲吭串?dāng)前狀態(tài)是否為 已上架如果不是就返回明確提示同時(shí)給用戶(hù) ID 加一個(gè)防重復(fù)提交標(biāo)記比如 Redis 里面存一個(gè) key這是企業(yè)級(jí)做法。但如果你不想引入 Redis也可以在 SQL 層面做判斷用一個(gè)帶house_id status的唯一約束兜底讓數(shù)據(jù)庫(kù)去擋第二次提交。下面這段代碼可以幫你理解查詢(xún)房源列表時(shí)常用的條件組合寫(xiě)法public IPageHouse getHouseList(int page, int size, String type, Integer status, String keyword) { LambdaQueryWrapperHouse wrapper new LambdaQueryWrapper(); if (StrUtil.isNotBlank(type)) { wrapper.eq(House::getType, type); } if (status ! null) { wrapper.eq(House::getStatus, status); } if (StrUtil.isNotBlank(keyword)) { wrapper.like(House::getTitle, keyword); } wrapper.orderByDesc(House::getCreateTime); return houseMapper.selectPage(new Page(page, size), wrapper); }這里我習(xí)慣用LambdaQueryWrapper好處是字段名是帶編譯時(shí)檢查的字段拼錯(cuò)會(huì)直接報(bào)錯(cuò)而不是運(yùn)行時(shí)才暴露問(wèn)題。分頁(yè)用的是 MyBatis-Plus 自帶的分頁(yè)插件前端傳page和size后端返回total和records這套交互協(xié)議在真實(shí)項(xiàng)目里也是標(biāo)準(zhǔn)做法。4.3 參數(shù)校驗(yàn)與統(tǒng)一返回格式很多新手項(xiàng)目最大的問(wèn)題是前后端各寫(xiě)各的字段名對(duì)不上錯(cuò)誤提示對(duì)不上。要避免這個(gè)問(wèn)題從第一天就要定好統(tǒng)一返回結(jié)構(gòu)。我常用這樣的 JSON 格式{ code: 0, message: success, data: {} }code0表示成功非 0 表示失敗。message是給用戶(hù)看的提示比如 用戶(hù)名或密碼錯(cuò)誤、圖片大小不能超過(guò)5MB。Android 端解析的時(shí)候只用判斷code是否為 0再拿到data來(lái)做后續(xù)邏輯非常省事。參數(shù)校驗(yàn)要依托Validated注解加實(shí)體類(lèi)字段約束比如NotBlank、NotNull、Min。千萬(wàn)別把一堆 if 判斷寫(xiě)在 controller 里誰(shuí)維護(hù)誰(shuí)知道痛苦。當(dāng)然校驗(yàn)不通過(guò)的異常也要集中處理用RestControllerAdvice ExceptionHandler把異常統(tǒng)一包裝成上面的 JSON 格式再返回給 Android 端。這一塊雖然在界面上看不到但在后端代碼評(píng)審時(shí)加分極多。5. Android 端實(shí)現(xiàn)細(xì)節(jié)5.1 項(xiàng)目結(jié)構(gòu)與網(wǎng)絡(luò)層搭建Android 端的源碼質(zhì)量直接決定這個(gè)項(xiàng)目給人第一印象好不好。我最反感的是把幾百行代碼全部寫(xiě)在 MainActivity 里頁(yè)面一多就變成 面條代碼。這個(gè)項(xiàng)目我建議至少分這么幾類(lèi)包bean存放對(duì)應(yīng)后端返回結(jié)構(gòu)的實(shí)體類(lèi)。api存放接口定義比如登錄接口、房源列表接口、收藏接口。adapter各個(gè)列表的適配器。activity/fragment頁(yè)面邏輯。utils公共工具類(lèi)PrefUtil、網(wǎng)絡(luò)判斷等。網(wǎng)絡(luò)層不用過(guò)度封裝但至少要做一個(gè)單例。我講解視頻里最常演示的是用 OkHttp 封裝一個(gè)HttpUtil類(lèi)內(nèi)部維護(hù)一個(gè) OkHttpClient 實(shí)例對(duì)外提供 get 和 post 方法。再在此基礎(chǔ)上加一個(gè)回調(diào)接口把成功和失敗分發(fā)出去這樣 Activity 里就不用關(guān)心線程切換問(wèn)題了。HttpUtil.post(house/list, params, new HttpUtil.CallBack() { Override public void onSuccess(String json) { // 解析 json更新 UI } Override public void onFailed(String msg) { Toast.makeText(MainActivity.this, msg, Toast.LENGTH_SHORT).show(); } });回調(diào)里要記得runOnUiThread切換主線程否則直接更新 TextView 會(huì)崩潰。這個(gè)細(xì)節(jié)很多初學(xué)者會(huì)忽略也是很常見(jiàn)的 Android 崩潰點(diǎn)。5.2 頁(yè)面清單與功能拆解在界面設(shè)計(jì)上一個(gè)完整租賃 App 至少要包含這些頁(yè)面登錄、注冊(cè)頁(yè)。主界面首頁(yè)房源列表或輪播推薦、類(lèi)型篩選、個(gè)人中心用 BottomNavigationView Fragment 實(shí)現(xiàn)。房源詳情頁(yè)圖片輪播、房屋信息、房東信息、收藏按鈕、預(yù)約看房/立即租房按鈕。發(fā)布房源頁(yè)表單錄入 多圖選擇上傳。我的訂單頁(yè)區(qū)分 我發(fā)布的 和 我租賃的。后臺(tái)管理頁(yè)房源審核、用戶(hù)列表、數(shù)據(jù)概覽。房源列表頁(yè)通常用 RecyclerView 展示Adapter 里的 item 布局要包含標(biāo)題、價(jià)格、戶(hù)型、面積、封面圖。這里有一個(gè)實(shí)際經(jīng)驗(yàn)列表頁(yè)不要一次性把所有字段都加載進(jìn)來(lái)尤其是images字段較長(zhǎng)很容易拖慢首次加載速度。更合理的做法是在列表接口中只返回圖片的第一張也就是前端截取逗號(hào)分隔結(jié)果的第一個(gè)這樣列表加載會(huì)明顯變快。圖片加載直接上 Glide。Glide 的好處是支持占位圖、錯(cuò)誤圖、內(nèi)存和磁盤(pán)緩存還能自動(dòng)處理 OOM 風(fēng)險(xiǎn)。如果你還在用它加載網(wǎng)絡(luò)圖片時(shí)忘記加路徑比如把http://192.168.1.100:8080/upload/1.png寫(xiě)成本地路徑那一定加載不出來(lái)。5.3 登錄狀態(tài)與 Token 管理Android 端的登錄態(tài)保存最簡(jiǎn)單可靠的是 SharedPreferences。登錄成功以后把 Token、userId、role 存下來(lái)在每次網(wǎng)絡(luò)請(qǐng)求的 header 里帶上 Token用戶(hù)在個(gè)人中心點(diǎn)擊退出登錄時(shí)清除這些數(shù)據(jù)并跳回登錄頁(yè)。這個(gè)流程看起來(lái)簡(jiǎn)單實(shí)際有幾個(gè)細(xì)節(jié)要注意。第一SharedPreferences 提交要用apply()而不是commit()因?yàn)榍罢呤钱惒綄?xiě)入不會(huì)卡主線程。第二不能把所有頁(yè)面都要求登錄比如首頁(yè)房源列表一定要允許未登錄訪問(wèn)否則搜索引擎和分享鏈接的場(chǎng)景會(huì)非常尷尬。第三當(dāng)某個(gè)接口返回 Token 失效時(shí)Android 端最好能統(tǒng)一彈出一個(gè)對(duì)話框讓用戶(hù)重新登錄而不是在每個(gè) Activity 里各自判斷。可以用一個(gè)全局的 Activity 管理工具在檢測(cè)到失效碼時(shí)關(guān)閉所有頁(yè)面并回到登錄頁(yè)這樣體驗(yàn)才像一個(gè)真正的商業(yè) App。6. 運(yùn)行部署與調(diào)試經(jīng)驗(yàn)6.1 本地啟動(dòng)步驟一個(gè)新環(huán)境要跑起這個(gè)系統(tǒng)順序很重要。先啟動(dòng) MySQL創(chuàng)建好數(shù)據(jù)庫(kù)house_rental修改后端配置里的數(shù)據(jù)庫(kù)連接字符串然后啟動(dòng) Spring Boot 項(xiàng)目。建議在src/main/resources下的application.yml中用外置配置覆蓋默認(rèn)配置這樣換環(huán)境不用改源碼。你可以這樣配置server: port: 8080 spring: datasource: url: jdbc:mysql://localhost:3306/house_rental?useUnicodetruecharacterEncodingutf8useSSLfalseserverTimezoneAsia/Shanghai username: root password: 123456 servlet: multipart: max-file-size: 5MB max-request-size: 20MB mybatis-plus: configuration: log-impl: org.apache.ibatis.logging.stdout.StdOutImpl啟動(dòng)后后端默認(rèn)端口 8080可以用 Postman 或者直接用瀏覽器訪問(wèn)http://localhost:8080/house/list驗(yàn)證接口能否返回 JSON。我每次都建議新人先跑通一個(gè)最簡(jiǎn)接口再寫(xiě)頁(yè)面不要一上來(lái)就全量堆代碼否則定位問(wèn)題會(huì)非常難。Android 端先在 Android Studio 里導(dǎo)入工程等待 Gradle 同步完成。注意本機(jī) Android SDK 版本要匹配項(xiàng)目配置最常見(jiàn)的報(bào)錯(cuò)是 SDK Build Tools 版本缺失AS 一般會(huì)提示自動(dòng)安裝。然后在模擬器或真機(jī)上運(yùn)行。用模擬器時(shí)后端地址一定要寫(xiě)成http://10.0.2.2:8080而不是localhost因?yàn)槟M器里localhost指向模擬器自己。用真機(jī)時(shí)填電腦的局域網(wǎng) IP并且保證手機(jī)和電腦連的是同一個(gè) Wi-Fi。6.2 常見(jiàn)聯(lián)調(diào)問(wèn)題與排查思路聯(lián)調(diào)階段我整理了下面幾個(gè)高頻問(wèn)題幾乎每個(gè)初學(xué)者都會(huì)遇到現(xiàn)象原因解決辦法Android 請(qǐng)求接口超時(shí)后端服務(wù)沒(méi)啟動(dòng)或地址填錯(cuò)先看后端控制臺(tái)日志再確認(rèn) IP/端口中文亂碼數(shù)據(jù)庫(kù)字符集不是 utf8mb4在建庫(kù)語(yǔ)句里指定DEFAULT CHARSETutf8mb4同時(shí)連接串加characterEncodingutf8圖片上傳后加載 404后端靜態(tài)資源映射未配置在 WebMvcConfig 中配置/upload/**資源映射到本地磁盤(pán)路徑房源列表一直加載失敗JSON 字段名與 JavaBean 不對(duì)應(yīng)打印后端返回 JSON檢查 Bean 字段名確認(rèn)有無(wú)SerializedName真機(jī)訪問(wèn)不了后端手機(jī)與電腦不在同一局域網(wǎng)/防火墻攔截關(guān)防火墻或放行 8080 端口用別的手機(jī)熱點(diǎn)測(cè)試關(guān)于跨域Android 原生 App 其實(shí)不受瀏覽器跨域限制但會(huì)有明文流量限制。如果后端是 http 而 Android 較高版本默認(rèn)禁止明文你需要在AndroidManifest.xml里設(shè)置usesCleartextTraffictrue不然請(qǐng)求會(huì)直接被攔截。這個(gè)問(wèn)題特別隱蔽我見(jiàn)過(guò)很多同學(xué)在模擬器上正常、在真機(jī)上掛了半天找不到原因。7. 二次開(kāi)發(fā)建議與避坑清單7.1 新手最容易踩的坑這個(gè)項(xiàng)目如果要作為畢設(shè)或者真實(shí)項(xiàng)目交付有幾個(gè)坑我真心建議避開(kāi)。第一個(gè)坑是時(shí)間字段的設(shè)計(jì)。很多新手會(huì)把starttime、endtime字段設(shè)計(jì)成 String直接存 2024-06-01 這樣的文本。這樣做的危害是排序、比較租期時(shí)會(huì)出錯(cuò)而且無(wú)法使用 MySQL 的時(shí)間函數(shù)。規(guī)范做法是用datetime類(lèi)型后端用LocalDateTime接收和返回前端再格式化展示。第二個(gè)坑是刪除數(shù)據(jù)的粗暴操作。房源、訂單這類(lèi)數(shù)據(jù)千萬(wàn)別用物理刪除。一旦用戶(hù)不小心誤刪或者面試官問(wèn) 如何恢復(fù)數(shù)據(jù)你就難堪了。建議加一個(gè)is_deleted字段做邏輯刪除MyBatis-Plus 也支持配置TableLogic注解查詢(xún)時(shí)自動(dòng)過(guò)濾刪除時(shí)自動(dòng)改為 update非常省心。第三個(gè)坑是接口權(quán)限遺漏。很多畢設(shè)項(xiàng)目只在界面上做了按鈕隱藏但接口完全沒(méi)有權(quán)限過(guò)濾用戶(hù)只要抓個(gè)包直接調(diào)用接口就能刪別人房源。這個(gè)系統(tǒng)里至少要保證 修改、刪除、審核 三類(lèi)接口都必須校驗(yàn)管理員或資源擁有者身份。實(shí)現(xiàn)方式是在 service 里傳入當(dāng)前用戶(hù) ID再和資源的user_id比對(duì)不一致就直接拋出 無(wú)權(quán)操作。7.2 可擴(kuò)展方向如果答辯時(shí)間充裕你完全可以在基礎(chǔ)功能上加幾個(gè)亮點(diǎn)成本和收益都高。在地圖上展示房源位置后端存經(jīng)緯度字段Android 端引入高德或者百度地圖 SDK做一個(gè)房源地圖視圖。這個(gè)功能視覺(jué)沖擊力強(qiáng)且實(shí)現(xiàn)不復(fù)雜。增加短信驗(yàn)證碼登錄借助第三方短信服務(wù)傳遞用戶(hù)手機(jī)號(hào)和驗(yàn)證碼替換一部分密碼登錄場(chǎng)景可以展示你對(duì)消息通信的理解。增加爬蟲(chóng)或者數(shù)據(jù)字典比如在后臺(tái)統(tǒng)計(jì)各區(qū)域房源數(shù)、平均租金用 ECharts 或 Android 圖表框架展示。這是妥妥的加分項(xiàng)。租約支付如果要做得像商業(yè)產(chǎn)品還需要抽象支付回調(diào)流程但畢設(shè)階段不一定落地可以在文檔里描述清楚設(shè)計(jì)思路。另外提一句如果你想把這個(gè)項(xiàng)目包裝成簡(jiǎn)歷項(xiàng)目切記不能只寫(xiě) 實(shí)現(xiàn)了房屋租賃 CRUD。要突出你在權(quán)限控制、狀態(tài)機(jī)設(shè)計(jì)、防重復(fù)提交、圖片上傳優(yōu)化、真機(jī)聯(lián)調(diào)兼容性這些點(diǎn)上的思考這才是面試官想聽(tīng)的東西。8. 實(shí)操體驗(yàn)與收尾建議最后分享一點(diǎn)個(gè)人體會(huì)。帶過(guò)幾屆學(xué)生做類(lèi)似的畢設(shè)和訓(xùn)練營(yíng)項(xiàng)目我發(fā)現(xiàn)大家最容易卡住的階段不是寫(xiě)代碼而是 代碼跑起來(lái)之后不知道干什么。拿到這套系統(tǒng)源碼后我建議你按三步走第一步不看代碼把后端數(shù)據(jù)庫(kù)建出來(lái)用 Postman 測(cè)一遍主要接口感受一下接口的請(qǐng)求和響應(yīng)結(jié)構(gòu)第二步對(duì)照源碼把接口實(shí)現(xiàn)捋清楚畫(huà)一張自己看得懂的調(diào)用鏈路圖第三步改一個(gè)小功能比如給房源列表增加按價(jià)格排序的參數(shù)親自動(dòng)手改代碼、重啟服務(wù)、驗(yàn)證效果。走完這三步這套系統(tǒng)才真正變成了你的東西。如果你打算在畢設(shè)答辯里講這個(gè)項(xiàng)目多準(zhǔn)備幾個(gè) 為什么 的回答。比如 為什么訂單狀態(tài)用 int 不用 String、為什么圖片地址用逗號(hào)拼接而不是關(guān)聯(lián)表、為什么登錄用 Token 不用 Session。這些問(wèn)題都是加分機(jī)會(huì)也是真正體現(xiàn)你深入理解項(xiàng)目的時(shí)刻。做這套系統(tǒng)難度不在于堆功能而在于把每個(gè)模塊之間的邊界打磨清楚。服務(wù)端只提供接口邏輯客戶(hù)端只負(fù)責(zé)展示和交互數(shù)據(jù)庫(kù)用合理字段支撐業(yè)務(wù)流轉(zhuǎn)。這套思路放到任何業(yè)務(wù)系統(tǒng)里都適用。希望這篇分享能幫你少走一些彎路把項(xiàng)目做得比大多數(shù)模板更有底氣。