mybatisplus報錯:Invalid bound statement(not found)問題及解決

更新時間：2025年02月22日 09:56:27 作者：猩猩之火

文章主要介紹了在使用MyBatis-Plus時遇到的`Invalid bound statement (not found)`錯誤的幾種常見原因和解決方法,包括namespace路徑不一致、函數名或標簽id不一致、構建未成功、掃包配置錯誤以及配置文件書寫錯誤

mybatisplus報錯:Invalid bound statement(not found)

有的同學，在搭建mybatis plus項目時，遇到Invalid bound statement (not found)的問題。

實質上是mapper接口和mapper.xml沒有映射起來。

這種情況，常見的問題有以下幾個：

1、mapper.xml 里面的 namespace與實際的mapper類路徑不一致

這個有個快捷的檢測辦法就是按住ctrl鍵，然后點擊namespace里面的包名
如果能跳到對應的類，那就說明沒有問題
如果你用的IDEA也是同樣的辦法，IDEA的包名是可以分段的，只要是能點進去都沒問題

2、mapper接口的函數名和mapper.xml里面的標簽id不一致

這個問題也很常見，最好的辦法還是粘貼復制過去，這樣可以確保沒有問題。

第1點和2點都是關于拼寫錯誤的情況。

3、構建沒有進去

請看一下target文件夾下面這些是否存在，沒有請重新構建。

4、查看掃包是否添加

我的是添加在springboot啟動類上面的。

5、檢查配置文件是否寫錯

#這個地方是否寫錯

mapper-locations: classpath:mybatis/mapper/**/*.xml

mybatis-plus可以是這樣的配置-數組形式：

mybatis-plus:
  mapper-locations:
    - classpath:mybatis/mapper/**/*.xml

或者是

mybatis-plus:
  mapper-locations: classpath:mybatis/**/*Mapper.xml

注意：這個key是mapper-locations 而不是mapper-location:

其他配置：

mybatis-plus:
  global-config:
    #主鍵類型  0:"數據庫ID自增", 1:"用戶輸入ID",2:"全局唯一ID (數字類型唯一ID)", 3:"全局唯一ID UUID";
    id-type: 0
    #字段策略 0:"忽略判斷",1:"非 NULL 判斷"),2:"非空判斷"
    field-strategy: 0
    #駝峰下劃線轉換
    db-column-underline: true
    #刷新mapper 調試神器
    refresh-mapper: true
    #數據庫大寫下劃線轉換
    #capital-mode: true 
    #序列接口實現(xiàn)類配置    
	#key-generator: com.baomidou.springboot.xxx 
    #邏輯刪除配置（下面3個配置）
    #logic-delete-value: 0 # 邏輯已刪除值(默認為 1)    
	#logic-not-delete-value: 1 # 邏輯未刪除值(默認為 0)    
	#自定義填充策略接口實現(xiàn)    
	#meta-object-handler: com.zhengqing.config.MyMetaObjectHandler   
	#自定義SQL注入器   
	#sql-injector: com.baomidou.springboot.xxx  configuration:      
    # SQL 解析緩存，開啟后多租戶 @SqlParser 注解生效
    #sql-parser-cache: true
  configuration:
    # 駝峰轉換 從數據庫列名到Java屬性駝峰命名的類似映射  
    map-underscore-to-camel-case: true
    # 是否開啟緩存
    cache-enable: false
    # 如果查詢結果中包含空值的列，則 MyBatis 在映射的時候，不會映射這個字段        
	#call-setters-on-nulls: true  
    # 打印sql
    log-impl: org.apache.ibatis.logging.stdout.StdOutImpl