mybatis mapper.xml 注釋帶參數(shù)的坑

最近做一個(gè)很簡單的統(tǒng)計(jì)項(xiàng)目，統(tǒng)計(jì)的邏輯產(chǎn)品一直改版，為了便于之后產(chǎn)品返回的時(shí)候快速的切換回老版本的邏輯，就給之前的sql注釋了直接在下面寫了新的sql,注釋的時(shí)候一般我都習(xí)慣性的選中之后Ctrl+/利用編輯器自帶的自動注釋功能，這個(gè)時(shí)候編輯器是分兩種情況的：情況一是你之前老的sql沒有類似<where>這樣帶特殊尖括號的語句，這個(gè)時(shí)候如果用Ctrl+/的話編輯器會用'--'也就是sql語句的注釋去注釋你之前的老sql，注釋完之后編輯器并不會報(bào)錯(cuò)如果比較幸運(yùn)你之前的語句里沒有參數(shù)的話執(zhí)行也是沒有問題的，但是，注意這個(gè)但是，如果你之前的sql語句帶#{xxxx}或者${xxx}這樣的參數(shù)，

形如下面這樣：

-- #{month,jdbcType=VARCHAR}

那么恭喜你，這個(gè)時(shí)候執(zhí)行的話就會報(bào)很詭異的異常，類似于下面這樣：

org.springframework.dao.TransientDataAccessResourceException: 
### Error querying database.  Cause: java.sql.SQLException: Parameter index out of range (1 > number of parameters, which is 0).

這個(gè)時(shí)候你可能會和我一樣丈二和尚摸不著頭腦，特別是如果之前么有遇見過這個(gè)問題的話，很有可能會在這里搞很久；情況二是你的老sql有<where>這樣的帶尖括號的語句，這個(gè)時(shí)候你用Ctrl+/的話，會自動是<!-- xxx-->也就是標(biāo)準(zhǔn)的xml注釋，這個(gè)時(shí)候即使你注釋的xxx包括外部參數(shù)占位，執(zhí)行的時(shí)候也不會報(bào)錯(cuò)，形如下面這樣也不會有問題：

<!-- ?#{month,jdbcType=VARCHAR}-->

這個(gè)問題由于之前自己沒有遇見過所以這次在這里卡了挺久才試出問題原因，至于兩種方式為何會有所區(qū)別回頭還得好好看看mybatis的源碼，之后再補(bǔ)充到這篇文章里，占用上班時(shí)間做個(gè)記錄

mybatis的xml中注釋需謹(jǐn)慎

報(bào)錯(cuò)內(nèi)容

java.sql.SQLException: Parameter index out of range (3 > number of parameters, which is 2)

調(diào)試半天，網(wǎng)上查了半天都是# 、$ 用法出錯(cuò)，一次次的對比，一個(gè)個(gè)字找，發(fā)現(xiàn)，用法根本沒問題，突然。。?？吹搅俗⑨屩械?/p>

#{executorId}，想想，也許是這個(gè)的原因呢？然后就給注釋刪了，結(jié)果發(fā)現(xiàn)就是注釋的鍋：

這樣，mybatis仍舊會把#{}算成一個(gè)帶注入的參數(shù)，二SQL認(rèn)出了這個(gè)-- 的注釋

-- AND (dept.id = #{executorId} OR dept.parentId = #{executorId} OR parentId in ( SELECT id from user_department
-- WHERE user_department.id = #{executorId} OR user_department.parentId = #{executorId} ))

小結(jié)一下

在mybatis的sql里不是不能寫注釋，而是注釋不能有#{}，mybatis仍舊會把#{}算成一個(gè)帶注入的參數(shù)

以上為個(gè)人經(jīng)驗(yàn)，希望能給大家一個(gè)參考，也希望大家多多支持腳本之家。