JeecgBoot项目中SQL查询权限字段映射问题解析

在使用JeecgBoot 3.7.2版本时，开发者在查询权限数据时遇到了字段映射错误的问题。本文将深入分析该问题的成因，并提供专业的解决方案。

问题现象

当执行权限查询操作时，返回结果中的部分字段值与数据库中的实际数据不符。通过检查发现，这是由于SQL查询结果映射方式不当导致的。

根本原因分析

问题的核心在于MyBatis的字段映射机制。在项目中存在两种常见的字段映射方式：

1. @TableField注解方式：适用于实体类与数据库表字段的自动映射
2. resultMap显式映射：适用于复杂查询或字段名不一致的情况

在本案例中，开发者错误地在手写SQL查询中混合使用了这两种方式。具体表现为：

• 手写SQL语句中直接使用了数据库原始字段名
• 但同时又依赖@TableField注解进行字段映射
• 这种混合使用方式导致MyBatis无法正确识别字段对应关系

解决方案

针对此问题，我们推荐以下两种解决方案：

方案一：使用resultMap显式映射（推荐）

<select id="queryPermissions" resultMap="SysPermission">
    SELECT id, permission_name, permission_code 
    FROM sys_permission
    WHERE del_flag = 0
</select>

这种方式的优势在于：

1. 明确指定了结果集与实体类的映射关系
2. 避免了注解与SQL语句的冲突
3. 可读性强，维护方便

方案二：统一字段命名

另一种解决方案是确保SQL查询中的字段名与实体类中的@TableField注解保持一致：

<select id="queryPermissions" resultType="com.jeecg.boot.entity.SysPermission">
    SELECT id AS id, 
           permission_name AS permissionName,
           permission_code AS permissionCode
    FROM sys_permission
    WHERE del_flag = 0
</select>

最佳实践建议

1. 保持一致性：在项目中统一使用一种字段映射方式，避免混合使用
2. 复杂查询优先使用resultMap：对于多表关联或复杂查询，resultMap是更好的选择
3. 简单查询可使用注解：单表简单查询可以依赖@TableField注解
4. 文档规范：在团队开发中，应制定明确的SQL编写规范

总结

JeecgBoot项目中的权限查询字段映射问题，本质上是MyBatis映射机制使用不当导致的。通过采用resultMap显式映射或统一字段命名的方式，可以有效解决此类问题。在实际开发中，建议团队根据项目复杂度选择合适的映射策略，并保持一致性，以提高代码的可维护性和可读性。