mybatisplus selectJoinList 字段名相同

### MyBatisPlus `selectJoinList` 方法字段名冲突解决方案 当使用 MyBatisPlus 的 `selectJoinList` 方法执行多表联结查询时，如果多个表中的字段名称相同，则可能会导致返回的结果集无法正确映射到目标对象中。这是因为 SQL 查询结果集中存在重复的列名，而 Java 对象在接收这些数据时会覆盖相同的属性值。 以下是几种常见的解决方法： #### 1. 使用别名区分字段 通过设置 SQL 别名为不同的字段命名，可以有效避免字段名冲突的问题。可以在实体类中定义对应的字段并标注其与数据库字段的关系[^1]。 ```java @TableName("t_user") public class User { @TableField(value = "id", alias = "user_id") // 设置别名 user_id private Long userId; @TableField(value = "name", alias = "user_name") // 设置别名 user_name private String userName; } ``` 对于关联表的字段也可以采用同样的方式处理： ```sql SELECT u.id AS user_id, u.name AS user_name, d.id AS dept_id, d.dept_name FROM t_user u LEFT JOIN t_department d ON u.dept_id = d.id WHERE ... ``` 这样，在返回的对象中可以通过指定的别名来访问不同表中的同名字段[^2]。 --- #### 2. 自定义 Mapper 接口实现复杂查询逻辑 如果内置的 `selectJoinList` 方法难以满足需求，可以选择自定义 Mapper 接口，并编写复杂的 SQL 脚本来完成特定功能。例如： ```java @Mapper public interface CustomUserMapper extends BaseMapper<User> { @Select("SELECT u.id as user_id, u.name as user_name, d.id as dept_id, d.name as dept_name FROM t_user u LEFT JOIN t_department d ON u.dept_id = d.id WHERE ... ") List<Map<String, Object>> getCustomJoinResult(); } ``` 这种方式允许开发者完全控制 SQL 查询语句的内容，从而灵活应对各种场景下的字段冲突问题[^3]。 --- #### 3. 返回 Map 类型而非实体类 另一种简单的方式是让查询结果直接返回为 `Map<String, Object>` 类型的数据结构而不是具体的实体类实例。由于 Maps 中存储的是键值对形式的数据，即使两个字段具有相同的原始名称也不会发生覆盖现象。 示例代码如下所示： ```java List<Map<String, Object>> resultList = customUserMapper.getCustomJoinResult(); for (Map<String, Object> map : resultList) { System.out.println(map.get("user_id")); System.out.println(map.get("dept_id")); } ``` 这种方法虽然牺牲了一定程度上的类型安全性，但在某些情况下确实更加便捷高效[^4]。 --- #### 4. 修改数据库设计减少冗余字段 从根本上解决问题的办法是对数据库的设计进行优化调整，尽量避免同一业务含义下出现过多重叠或者相似意义的字段。比如将公共部分提取出来形成单独的一张辅助表格等等[^5]。 --- ### 总结 针对 MyBatisPlus 在调用 `selectJoinList` 方法过程中遇到的字段名冲突情况，推荐优先考虑利用 **SQL 别名机制** 来重新定义各字段的实际表现形式；其次还可以借助于 **自定义 mapper 层接口** 或者干脆切换至基于哈希表的形式来进行临时性的转换操作。当然最理想的状态当然是能够提前规划好整个系统的架构布局，尽可能规避掉此类潜在隐患的发生几率。