有一些小伙伴覺得 MyBatis 只有方法中存在多個參數的時候，才需要添加 @Param 注解，其實這個理解是不準確的。即使 MyBatis 方法只有一個參數，也可能會用到 @Param 注解。
但是，在你總結出規(guī)律之前，你可能會覺得莫名其妙，有的時候一個參數明明不用添加 @Param 注解，有的時候，卻需要添加，不添加會報錯。

創(chuàng)新互聯建站是一家網站設計公司，集創(chuàng)意、互聯網應用、軟件技術為一體的創(chuàng)意網站建設服務商，主營產品：響應式網站開發(fā)、成都品牌網站建設、成都全網營銷。我們專注企業(yè)品牌在網站中的整體樹立，網絡互動的體驗，以及在手機等移動端的優(yōu)質呈現。成都網站設計、網站制作、移動互聯產品、網絡運營、VI設計、云產品.運維為核心業(yè)務。為用戶提供一站式解決方案，我們深知市場的競爭激烈，認真對待每位客戶，為客戶提供賞析悅目的作品，網站的價值服務。

有的人會覺得這是 MyBatis 各個版本差異的鍋，不可否認，MyBatis 發(fā)展很快，不同版本之間的差異還挺明顯的，不過這個加不加 @Param 注解的問題，卻并不是版本的鍋！今天松哥就和大家來聊一聊這個問題，到底哪些情況下需要添加 @Param 注解。
首先，如下幾個需要添加 @Param 注解的場景，相信大家都已經有共識了：
第一種：方法有多個參數，需要 @Param 注解

@Mapper
public interface UserMapper {
    Integer insert(@Param("username") String username, @Param("address") String address);
}

對應的 XML 文件如下：

    insert into user (username,address) values (#{username},#{address});

這是最常見的需要添加 @Param 注解的場景。

第二種：方法參數要取別名，需要 @Param 注解
當需要給參數取一個別名的時候，我們也需要 @Param 注解，例如方法定義如下：

@Mapper
public interface UserMapper {
    User getUserByUsername(@Param("name") String username);
}

對應的 XML 定義如下：

    select * from user where username=#{name};

老實說，這種需求不多，費事。

第三種：XML 中的 SQL 使用了 $ ，那么參數中也需要 @Param 注解
會有注入漏洞的問題，但是有的時候你不得不使用符號，例如要傳入列名或者表名的時候，這個時候必須要添加 @Param 注解，例如：

@Mapper
public interface UserMapper {
    List getAllUsers(@Param("order_by")String order_by);
}

對應的 XML 定義如下：

    select * from user
    
        order by ${order_by} desc
    

前面這三種，都很容易懂，相信很多小伙伴也都懂，除了這三種常見的場景之外，還有一個特殊的場景，經常被人忽略。

第四種，那就是動態(tài) SQL ，如果在動態(tài) SQL 中使用了參數作為變量，那么也需要 @Param 注解，即使你只有一個參數。
如果我們在動態(tài) SQL 中用到了 參數作為判斷條件，那么也是一定要加 @Param 注解的，例如如下方法：

@Mapper
public interface UserMapper {
    List getUserById(@Param("id")Integer id);
}

定義出來的 SQL 如下：

    select * from user
    
        where id=#{id}
    

這種情況，即使只有一個參數，也需要添加 @Param 注解，而這種情況卻經常被人忽略！
好了，不知道大家有沒有 GET 到呢？有問題歡迎留言討論。