MyBatis 多表查詢?nèi)N最常見(jiàn)的寫(xiě)法

更新時(shí)間：2025年04月22日 10:21:02 作者：扶風(fēng)_w

這篇文章主要介紹了MyBatis 多表查詢?nèi)N最常見(jiàn)的寫(xiě)法,本文給大家介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或工作具有一定的參考借鑒價(jià)值,需要的朋友參考下吧

前言：一張關(guān)聯(lián)表，讓你頭禿了嗎？

你是不是也寫(xiě)過(guò)這種需求：

查詢某個(gè)用戶及其角色列表
查詢訂單及明細(xì)
查詢項(xiàng)目及其下屬的多個(gè)階段和負(fù)責(zé)人

最后寫(xiě)了一堆復(fù)雜 SQL + resultMap，運(yùn)行一看，要么數(shù)據(jù)重復(fù)、要么數(shù)據(jù)丟失，最慘還可能觸發(fā) N+1 查詢……

其實(shí)問(wèn)題不是 MyBatis 不行，而是你用的方法不對(duì)。

?? 三種最常見(jiàn)的寫(xiě)法

? 方式一：聯(lián)表查詢 + 扁平映射（推薦）

這是我最常用也最穩(wěn)定的一種方式：寫(xiě)一條聯(lián)表 SQL，把需要的字段都查出來(lái)，返回扁平結(jié)構(gòu)，再在 Java 層進(jìn)行組裝。

示例 SQL：

SELECT u.id AS userId, u.name AS userName,
       r.id AS roleId, r.name AS roleName
FROM user u
LEFT JOIN user_role ur ON u.id = ur.user_id
LEFT JOIN role r ON ur.role_id = r.id

特點(diǎn)：

一條 SQL 查全所有數(shù)據(jù)；
性能高，邏輯直觀；
可與分頁(yè)插件（如 PageHelper）完美配合。

我的建議：

Java 層用 Map<Long, UserDTO> 分組封裝，適合在 Service 層統(tǒng)一做聚合邏輯。

?? 方式二：嵌套結(jié)果（resultMap + collection）

適合結(jié)構(gòu)較為清晰的“樹(shù)狀結(jié)構(gòu)”，比如訂單和訂單項(xiàng)、項(xiàng)目和子模塊。

示例 XML：

<resultMap id="userMap" type="User">
  <id property="id" column="user_id"/>
  <result property="name" column="user_name"/>
  <collection property="roles" ofType="Role">
    <id property="id" column="role_id"/>
    <result property="name" column="role_name"/>
  </collection>
</resultMap>

特點(diǎn)：

多表映射層級(jí)清晰；
比較適合中小型數(shù)據(jù)量。

踩坑經(jīng)驗(yàn)：

寫(xiě)錯(cuò)列名字段，就會(huì)導(dǎo)致內(nèi)層集合全是 null；
出現(xiàn)重復(fù)數(shù)據(jù)時(shí)，要手動(dòng)去重或用 Set；
不適合配合分頁(yè)，容易導(dǎo)致“分頁(yè)的是主表，但集合是全量”。

?? 方式三：嵌套查詢（nested select）

適合邏輯解耦，按模塊維護(hù)的場(chǎng)景。

示例 XML：

<collection property="roles" ofType="Role" select="selectRolesByUserId" column="id"/>

特點(diǎn)：

每條主表數(shù)據(jù)觸發(fā)一次副查詢；
易維護(hù)但 極易 N+1；
不適合大批量數(shù)據(jù)查詢。

實(shí)戰(zhàn)建議：

除非你能保證每次最多查詢 10 條主記錄，否則慎用。性能瓶頸很容易出現(xiàn)在這里！

?? 你可能踩過(guò)的坑

問(wèn)題	癥狀	原因	建議
查詢結(jié)果為 null	子集合沒(méi)數(shù)據(jù)	字段名或別名不匹配	顯式寫(xiě) column 屬性或使用 @Results 映射
一對(duì)多重復(fù)數(shù)據(jù)	主表字段重復(fù)出現(xiàn)	聯(lián)表未分組 / Java 封裝沒(méi)處理	手動(dòng)分組聚合，避免直接用 List
分頁(yè)異常	只分頁(yè)主表，子表數(shù)據(jù)混亂	不支持嵌套分頁(yè)	聯(lián)表 + 扁平查詢是最佳方案
查詢慢到爆炸	N+1 查詢	每條主記錄觸發(fā)一次 select	轉(zhuǎn)成 join 聯(lián)查或改為批量查

? 實(shí)戰(zhàn)建議：如何選擇這三種方式？

類(lèi)型	性能	可維護(hù)性	適合場(chǎng)景
聯(lián)表扁平查詢	?????	??	大批量、一對(duì)多、分頁(yè)場(chǎng)景
嵌套結(jié)果 resultMap	???	????	結(jié)構(gòu)清晰、數(shù)據(jù)量適中
子查詢 nested	??	?????	小數(shù)據(jù)量、邏輯獨(dú)立場(chǎng)景

?? 我的最佳實(shí)踐模板（真實(shí)項(xiàng)目用的）

DAO 層只查數(shù)據(jù)，不做結(jié)構(gòu)組裝；
Service 層按業(yè)務(wù)模型拼裝 DTO；
多表結(jié)果不要直接給前端，統(tǒng)一封裝響應(yīng)結(jié)構(gòu)；
DTO + Builder 模式 + Map 分組，靈活好用；

?? 總結(jié)一句話：

多表查詢選對(duì)方式，寫(xiě)代碼少掉一半 bug。

不必糾結(jié)哪種方式最“完美”，關(guān)鍵是是否適合你當(dāng)前場(chǎng)景。
記?。?strong>能用聯(lián)查查全的，就別搞子查詢；分頁(yè)場(chǎng)景盡量別用嵌套結(jié)構(gòu)；小數(shù)據(jù)就圖方便，結(jié)構(gòu)優(yōu)先。

到此這篇關(guān)于MyBatis 多表查詢的文章就介紹到這了,更多相關(guān)MyBatis 多表查詢內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: