MyBatis 查询结果为 null 时报错，如何解决？

在使用MyBatis进行数据库操作时,和是两种常见的参数占位符，但它们的处理机制和适用场景存在显著差异，直接将参数值拼接到SQL语句中，而则采用预编译方式处理参数，当参数为null时，可能会导致SQL语法错误或程序异常，因此需要特别注意其使用场景和异常处理。

与的核心区别

MyBatis中,是字符串替换机制，直接将参数值插入到SQL语句中。${param}会被替换为实际的参数值，若参数为null，则SQL语句中可能出现WHERE column =或ORDER BY等语法错误，相比之下，使用预编译（PreparedStatement）处理参数，会自动进行类型转换和转义，即使参数为null，也会被转换为NULL字符串，确保SQL语法正确。#{param}在预编译后会被替换为，执行时由JDBC驱动处理null值。

为null的常见报错场景

1. 动态表名或列名：
   当用于动态指定表名或列名时，若参数为null，SQL语句可能因缺少标识符而报错。

   SELECT * FROM ${tableName}  

   若tableName为null，生成的SQL为SELECT * FROM，直接导致语法错误。

2. 动态排序条件：
   在动态排序场景中，用于拼接ORDER BY子句，若参数为null，可能生成ORDER BY或ORDER BY , column等无效语句。

   SELECT * FROM users ORDER BY ${orderBy}  

   若orderBy为null，SQL语句将因排序字段缺失而报错。

   

3. 动态WHERE条件：
   若用于拼接WHERE条件，且参数为null，可能导致条件不完整。

   SELECT * FROM users WHERE status = ${status}  

   当status为null时，SQL变为SELECT * FROM users WHERE status =，触发语法异常。

解决方案与最佳实践

1. 参数校验与默认值：
   在Service层或Mapper接口中，对可能为null的参数进行校验，或设置默认值。

   String tableName = Optional.ofNullable(param).orElse("default_table");  

2. ：
   结合MyBatis的动态SQL标签，避免直接拼接可能为null的参数。

   <select id="selectUsers" resultType="User">  
       SELECT * FROM users  
       <if test="orderBy != null">  
           ORDER BY ${orderBy}  
       </if>  
   </select>  

3. 替换为或Java代码处理：
   若参数可能为null，优先使用，若必须使用，可通过Java代码处理null值，

   

   ORDER BY ${orderBy != null ? orderBy : 'id'}  

4. 异常捕获与日志记录：
   在DAO层捕获SQL异常，并记录日志以便排查问题。

   try {  
       sqlSession.selectList("com.example.mapper.UserMapper.selectUsers", param);  
   } catch (Exception e) {  
       log.error("SQL执行失败，参数: {}", param, e);  
       throw new RuntimeException("数据库操作异常");  
   }  

相关问答FAQs

A: 是字符串替换机制，直接将参数值拼接到SQL中，若参数为null，生成的SQL语句会缺少必要的标识符（如表名、列名）或关键字（如、），导致语法解析失败。WHERE column =会被数据库引擎视为无效语法。

Q2: 如何在必须使用的场景下避免null值报错？
A: 可通过以下方式处理：

1. 参数预处理：在调用Mapper前，对可能为null的参数设置默认值或空字符串。
2. 动态SQL拼接：使用MyBatis的<if>、<choose>等标签，仅在参数非null时拼接部分。
3. Java代码兜底：在XML中通过三元运算符或COALESCE函数提供备选值，如${param != null ? param : 'default'}。