缺少 @MapKey 注解

一、项目背景

本项目采用 Spring Boot 框架进行搭建，数据库操作层面选用了 MyBatis ORM 框架，数据库管理系统为 MySQL。

二、需求背景

1. 动态表结构需求

在项目中，存在一种特殊需求，即需要根据用户提交的表单动态创建数据库表 t_table。这意味着该表的字段（如列名、数据类型等）不是预定义的，而是根据表单的内容动态生成的。这种设计在需要高度灵活性和自定义化的应用中非常有用，如用户自定义报告、数据收集平台等。

2. 查询动态表并返回 Map 集合

由于表结构是动态生成的，因此在查询这些数据时，很难事先定义一个固定的 Java 对象来接收查询结果。因此，选择使用 Map 集合来接收每行的数据，其中 Map 的键为列名，值为对应的列值。这种方式可以灵活地处理未知或动态变化的列结构。

3. 解决“@MapKey is required”问题

在 MyBatis 的 Mapper 层编写查询方法，并希望以 Map 集合的形式接收返回结果时，如果直接使用 Map 作为返回值，并且期望 Map 的键具有某种特定的含义（比如行ID或特定列作为键），可能会遇到“@MapKey is required”的提示。这是因为 MyBatis 需要明确知道如何构建 Map 的键。

三、解决方案

1.使用 MapKey 注解

Map<Long, Map<String, String>>。范型类型可以修改。

• Map的key：一般存储每条记录的主键，也可以用其他值表示，主要取决于Dao层@MapKey注解后面的字段（如@MapKey("id")）；
• Map的value：也是一个Map，表示查询出这条记录的每个字段的字段名称和字段值。

2.返回 List<Map<String, Object>>

在大多数情况下，直接返回 List<Map<String, Object>> 更为直接和简单。这样每个 Map 代表一行数据，Map 的键是列名，值是对应的数据。这种方式不需要 @MapKey 注解，因为 Map 的键已经由列名自然形成。