MybatisPlus調(diào)用原生SQL的三種方法實例詳解

第MybatisPlus調(diào)用原生SQL的三種方法實例詳解目錄前言方法一方法二方法三MyBatis-Plus執(zhí)行原生SQL

前言

在有些情況下需要用到MybatisPlus查詢原生SQL，MybatisPlus其實帶有運行原生SQL的方法，我這里列舉三種

方法一

這也是網(wǎng)上流傳最廣的方法，但是我個人認為這個方法并不優(yōu)雅，且采用${}的方式代碼審計可能會無法通過，會被作為代碼漏洞

publicinterfaceBaseMapperTextendscom.baomidou.mybatisplus.core.mapper.BaseMapperT{

@Select("${nativeSql}")

ObjectnativeSql(@Param("nativeSql")StringnativeSql);

}

使用一個自己的BaseMapper去繼承MybatisPlus自己的BaseMapper，然后所有的Mapper去繼承自己寫的BaseMapper即可。那么所有的Mapper都能查詢原生SQL了。

問題在于${nativeSql}可能會被作為代碼漏洞，我并不提倡這種寫法。

方法二

使用SqlRunner的方式執(zhí)行原生SQL。這個方法我較為提倡，也是MybatisPlus源碼的測試類中用的最多的方法。

下圖為MybatisPlus源碼的測試類：

要使用SqlRunner的前提是打開SqlRunner，編輯application.yaml增加配置如下：

mybatis-plus:

global-config:

enable-sql-runner:true

perties寫法：

mybatis-plus.global-config.enable-sql-runner=true

如果不打開會報

Cause:java.lang.IllegalArgumentException:MappedStatementscollectiondoesnotcontainvalueforxxxxxxx

使用方法：

ListMapString,ObjectmapList=SqlRunner.db().selectList("select*fromtest_examplelimit1,10");

我個人比較推薦使用這種方式來查詢原生SQL，既不會污染Mapper，也不會被報出代碼漏洞。

方法三

采用原始的洪荒之力，用Mybatis最底層的方式執(zhí)行原生SQL

Stringsql="select*fromtest_examplelimit1,10";

ClassExampleEntityentityClass=ExampleEntity.class;

//INFO:DCTANT:2025/9/29使用MybatisPlus自己的SqlHelper獲取SqlSessionFactory

SqlSessionFactorysqlSessionFactory=SqlHelper.sqlSessionFactory(ExampleEntity.class);

//INFO:DCTANT:2025/9/29通過SqlSessionFactory創(chuàng)建一個新的SqlSession，并獲取全局配置

SqlSessionsqlSession=sqlSessionFactory.openSession();

Configurationconfiguration=sqlSessionFactory.getConfiguration();

//INFO:DCTANT:2025/9/29生成一個uuid，用于將這個SQL創(chuàng)建的MappedStatement注冊到MybatisPlus中

StringsqlUuid=UUID.fastUUID().toString(true);

RawSqlSourcerawSqlSource=newRawSqlSource(configuration,sql,Object.class);

MappedStatement.Builderbuilder=newMappedStatement.Builder(configuration,sqlUuid,rawSqlSource,SqlCommandType.SELECT);

ArrayListResultMapresultMaps=newArrayList();

//INFO:DCTANT:2025/9/29創(chuàng)建返回映射

ResultMap.BuilderresultMapBuilder=newResultMap.Builder(configuration,UUID.fastUUID().toString(true),entityClass,newArrayList());

ResultMapresultMap=resultMapBuilder.build();

resultMaps.add(resultMap);

builder.resultMaps(resultMaps);

MappedStatementmappedStatement=builder.build();

//INFO:DCTANT:2025/9/29將創(chuàng)建的MappedStatement注冊到配置中

configuration.addMappedStatement(mappedStatement);

//INFO:DCTANT:2025/9/29使用SqlSession查詢原生SQL

ListExampleEntitylist=sqlSession.selectList(sqlUuid);

//INFO:DCTANT:2025/9/29關閉session

sqlSession.close();

其中的UUID是Hutool中的方法，用于生成隨機字符串。

這個方法就不需要打開SqlRunner了，就是代碼量感人，我不是很推薦，但是能夠窺探一下MybatisPlus的底層邏輯。

MyBatis-Plus執(zhí)行原生SQL

在mapper文件中定義要執(zhí)行的方法

@Repository

publicinterfaceZbArticleCEIResultPerformanceMapperextendsBaseMapperZbArticleCEIResu