SpringBoot使用@Mapper注解无效解决办法

<think>好的，用户想了解Java中的Mapper注释。首先，我需要确认Mapper注释通常指的是在MyBatis或类似ORM框架中使用的注解，比如@Mapper、@Select、@Insert等。用户可能是刚开始学习MyBatis，或者在项目中遇到了相关的问题，需要了解如何正确使用这些注解。 接下来，我应该先解释Mapper注释的基本概念，说明它们的作用，比如用于简化数据库操作，替代XML配置。然后分点介绍常用的注解，每个注解的用途、语法和示例。同时，用户可能想知道如何结合Spring使用，比如@MapperScan的作用，这也是需要提到的部分。 还要注意用户可能的疑问点，比如为什么要用注解而不是XML，或者注解和XML配置的区别，应该在注意事项里说明两者的适用场景。此外，常见问题如接口绑定、参数传递这些容易出错的地方，也需要举例说明解决方案。 需要确保语言通俗易懂，结构清晰，步骤分明。同时检查是否有遗漏的重要注解，比如@Results、@Result，这些在处理结果映射时也很重要。最后，提醒用户注意注解使用的限制，比如复杂SQL可能还是需要XML，以及动态SQL的处理方式。 现在组织内容，先概述，再分常用注解详细介绍，然后使用示例，注意事项和常见问题。确保每个部分都有实际代码示例，帮助用户理解。同时，保持中文表达准确，避免技术术语使用不当。</think>关于Mapper注释的逐步解析： 1. Mapper基础概念 - Mapper是MyBatis框架的核心接口 - 作用：在Java接口方法与SQL语句之间建立映射 - 替代传统的XML映射文件写法（也可混合使用） 2. 常用Mapper注解清单 (1) @Mapper (MyBatis) $$@Mapper$$ - 标记接口为MyBatis的Mapper接口 - 被标注的接口会生成实现类代理对象 - 示例： ```java @Mapper public interface UserMapper { // SQL操作方法 } ``` (2) @MapperScan (Spring整合) $$@MapperScan("com.example.mapper")$$ - 用于Spring Boot启动类 - 批量扫描指定包下的Mapper接口 - 替代逐个使用@Mapper注解 - 示例： ```java @SpringBootApplication @MapperScan("com.example.mapper") public class Application { public static void main(String[] args) { SpringApplication.run(Application.class, args); } } ``` 3. SQL操作注解 (1) @Select ```java @Select("SELECT * FROM users WHERE id = #{id}") User getUserById(int id); ``` (2) @Insert ```java @Insert("INSERT INTO users(name,age) VALUES(#{name},#{age})") @Options(useGeneratedKeys=true, keyProperty="id") int insertUser(User user); ``` (3) @Update ```java @Update("UPDATE users SET name=#{name} WHERE id=#{id}") int updateUserName(@Param("name") String name, @Param("id") int id); ``` (4) @Delete ```java @Delete("DELETE FROM users WHERE id=#{id}") int deleteUser(int id); ``` 4. 高级映射注解 (1) @Results 和 @Result ```java @Results({ @Result(property = "userId", column = "user_id"), @Result(property = "userName", column = "username") }) @Select("SELECT user_id, username FROM users") List<User> getAllUsers(); ``` (2) @One (一对一关联) ```java @Result(property = "department", column = "dept_id", one = @One(select = "com.example.mapper.DeptMapper.getDeptById")) ``` (3) @Many (一对多关联) ```java @Result(property = "orders", column = "user_id", many = @Many(select = "com.example.mapper.OrderMapper.getOrdersByUserId")) ``` 5. 参数处理注解 (1) @Param ```java @Select("SELECT * FROM users WHERE name = #{name} AND age = #{age}") User findUser(@Param("name") String username, @Param("age") Integer userAge); ``` (2) 参数占位符类型 - #{}：预编译参数（防SQL注入） - ${}：直接文本替换（慎用） 6. 动态SQL支持 ```java @SelectProvider(type = UserSqlBuilder.class, method = "buildGetUserByName") User getUserByName(String name); class UserSqlBuilder { public static String buildGetUserByName(final String name) { return new SQL(){{ SELECT("*"); FROM("users"); if (name != null) { WHERE("name like #{name} || '%'"); } }}.toString(); } } ``` 注意事项： 1. 注解 vs XML配置 - 注解适合简单SQL语句 - 复杂SQL建议使用XML配置 - 可混合使用但需注意优先级 2. 常见问题排查 - 接口未添加@Mapper或未被扫描 - 参数未正确使用@Param注解 - 结果集字段与属性名不匹配 - SQL语法错误（注意注解中的字符串拼接） 最佳实践建议： 1. 简单CURD操作使用注解方式 2. 关联查询建议使用XML配置 3. 动态SQL优先选择@SelectProvider 4. 保持接口方法的单一职责原则