MyBatis执行更新操作时提示：Error selecting key or setting result to parameter object. Cause: org.apache.ibatis.executor.result.ResultMappingException

Question

在使用MyBatis执行更新操作时，如果遇到错误提示“Error selecting key or setting result to parameter object. Cause: org.apache.ibatis.executor.result.ResultMappingException”，通常是由于以下原因之一：1) 使用了useGeneratedKeys="true"但数据库表的主键并非自增类型；2) SQL语句中未正确设置参数或返回值映射；3) MyBatis配置文件中的resultMap定义有误。例如，当执行update语句并期望获取生成的主键时，若表结构不支持自增主键或SQL语法不匹配（如MySQL与Oracle差异），就会触发该异常。解决方法包括检查数据库表设计是否符合预期、调整SQL语句以适配具体数据库特性，以及确保MyBatis映射文件中的useGeneratedKeys和keyProperty属性配置正确。此外，还需确认驱动程序版本与数据库兼容，避免因驱动问题导致异常。

Answer 1

1. 问题概述

在使用MyBatis执行更新操作时，如果遇到错误提示“Error selecting key or setting result to parameter object. Cause: org.apache.ibatis.executor.result.ResultMappingException”，通常与数据库表设计、SQL语句配置以及MyBatis映射文件相关。以下是可能导致该问题的常见原因：

• 1) 使用了useGeneratedKeys="true"但数据库表的主键并非自增类型。
• 2) SQL语句中未正确设置参数或返回值映射。
• 3) MyBatis配置文件中的resultMap定义有误。

例如，当执行update语句并期望获取生成的主键时，若表结构不支持自增主键或SQL语法不匹配（如MySQL与Oracle差异），就会触发该异常。

2. 原因分析

为了更深入地理解问题根源，我们需要从以下几个方面进行分析：

1. 数据库表设计：检查主键是否为自增类型，或者是否通过其他方式生成唯一标识符。
2. SQL语句配置：确认SQL语句是否正确设置了参数和返回值映射，特别是在跨数据库平台时需注意语法差异。
3. MyBatis映射文件：确保useGeneratedKeys和keyProperty属性配置正确，避免因映射错误导致异常。

此外，还需确认驱动程序版本与数据库兼容，避免因驱动问题导致异常。

3. 解决方案

根据上述分析，以下是具体的解决方案：

问题类型	解决方法
主键非自增类型	调整数据库表设计，将主键改为自增类型；或修改SQL语句以手动生成主键。
SQL语句配置错误	检查SQL语句中的参数和返回值映射，确保其符合数据库特性及MyBatis要求。
MyBatis映射文件错误	校正useGeneratedKeys和keyProperty属性，确保其与实际需求一致。

同时，建议升级数据库驱动程序至最新稳定版本，以减少潜在兼容性问题。

4. 示例代码

以下是一个典型的MyBatis更新操作示例，展示了如何正确配置useGeneratedKeys和keyProperty属性：

        <insert id="insertUser" useGeneratedKeys="true" keyProperty="id">
            INSERT INTO users (name, age)
            VALUES (#{name}, #{age})
        </insert>
    

对于非自增主键的情况，可以通过手动指定主键生成逻辑来解决问题：

        <insert id="insertUserWithCustomKey" parameterType="map">
            <selectKey keyProperty="id" resultType="int" order="BEFORE">
                SELECT NEXTVAL('user_seq')
            </selectKey>
            INSERT INTO users (id, name, age)
            VALUES (#{id}, #{name}, #{age})
        </insert>
    

5. 流程图

以下是解决该问题的流程图，帮助开发者快速定位并解决问题：

graph TD
            A[出现异常] --> B{主键是否自增}
            B --是--> C{SQL语句是否正确}
            B --否--> D{是否需要手动生成主键}
            C --是--> E[检查MyBatis配置]
            C --否--> F[修正SQL语句]
            D --是--> G[调整SQL语句]
            D --否--> H[检查驱动版本]