解决MyBatisPlus报错：Failed to process, please exclude the tableName or statementId

小鱼儿 2023-02-24 12:26 13阅读 0赞

**报错详情：**  
`Error querying database. Cause: com.baomidou.mybatisplus.core.exceptions.MybatisPlusException: Failed to process, please exclude the tableName or statementId. Error SQL: xxxxxxxx`

**报错原因：**  
使用了自定义SQL，可能含有特殊的函数或者复杂的语法，因而不被`JSqlParser`(SQL解析器)所支持(无法添加`租户id`之类的字段)，以致抛出了`JSQLParserException`。

该异常又被MyBatisPlus捕获，并封装成`MybatisPlusException`后抛出。

源码：`com.baomidou.mybatisplus.core.parser.AbstractJsqlParser`  
![异常解析图][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L25pYm9ubm4_size_16_color_FFFFFF_t_70]  
**解决方法：**  
`Failed to process, please exclude the tableName or statementId`  
翻译过来就是：`处理失败，请将表名或者语句id进行排除。`  
P.S. 提示的很具体，但读起来容易懵，因为不熟悉的人并不知道是租户id出了问题

**方法一：排除表名**  
在配置MyBatisPlus的`TenantHandler`时在`doTableFilter`方法中将该表过滤掉（也就是不处理这个表的`租户id`字段）。

**方法二：排除该语句**  
在自定义SQL的接口上标注 `@SqlParser(filter = true)`：

@SqlParser(filter = true)
        @Select("此处应有很酷炫的SQL")
        void selectDemo();

官方对于此注解的解释是：

> 租户注解，支持method上以及mapper接口上，默认值为false；  
> true 表示过滤SQL解析，即不会进入ISqlParser解析链；  
> false 会进解析链并追加例如tenant\_id等条件。

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L25pYm9ubm4_size_16_color_FFFFFF_t_70]: /images/20230209/169f7270e85647efbda31ace363d7e00.png