小姐姐挖坑我来跳（一）mybatis传参

小姐姐挖坑我来跳（一）mybatis传参

前言

隔壁漂亮的小姐姐是个刚毕业的程序媛，作为一个乐于助人的好同事，小姐姐有了问题怎么能放任不管，一定要好好的给小姐姐安排的明明白白的。不要最觉得我是的LSP，我只是想借着给小姐姐解决问题，边聊天边划水。

问题

在愉快的划万水解决完问题，部署服务的大哥突然找过来说是登陆接口报错了，一看Git提交记录竟然是小姐姐提交的。就是刚刚我俩愉快的下午时光那会提上去的。完了小姐姐心中的大佬形象要轰然崩塌了，会不会以后不找我聊天了呢，先解决问题，不想那些！

在我一通操作猛如虎的情况下，终于找到了问题。竟然是小姐姐好心给mybatis的Mapper接口加入了@Param导致的。让我们用简单的代码还原一下。

pom

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.5.2</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
    <groupId>com.example</groupId>
    <artifactId>code</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>code</name>
    <description>Demo project for Spring Boot</description>
    <properties>
        <java.version>1.8</java.version>
    </properties>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-jdbc</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.mybatis.spring.boot</groupId>
            <artifactId>mybatis-spring-boot-starter</artifactId>
            <version>1.3.2</version>
        </dependency>
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <scope>runtime</scope>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>RELEASE</version>
            <scope>test</scope>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>

</project>

application.properties spring配置文件

spring.datasource.username=root
spring.datasource.password=root
spring.datasource.url=jdbc:mysql://localhost:3306/mytest?useUnicode=true&characterEncoding=utf-8&useSSL=true&serverTimezone=UTC
spring.datasource.driver-class-name=com.mysql.jdbc.Driver

mybatis.mapper-locations=classpath:mapper/*.xml

UserBasePo 用户实体类

public class UserBasePo {

    private Integer id;
    private String username;
    private String password;
    private String realName;

    public Integer getId() {
        return id;
    }

    public void setId(Integer id) {
        this.id = id;
    }

    public String getUsername() {
        return username;
    }

    public void setUsername(String username) {
        this.username = username;
    }

    public String getPassword() {
        return password;
    }

    public void setPassword(String password) {
        this.password = password;
    }

    public String getRealName() {
        return realName;
    }

    public void setRealName(String realName) {
        this.realName = realName;
    }

    @Override
    public String toString() {
        return "UserBasePo{" +
                "id=" + id +
                ", username='" + username + '\'' +
                ", password='" + password + '\'' +
                ", realName='" + realName + '\'' +
                '}';
    }
}

UserMapper mapper接口

@Mapper
public interface UserMapper {
    //这是小姐姐修改前的版本
    List<UserBasePo> getList(String username);
	//这是小姐姐修改后的版本，只是多加了@Param("username")
//    List<UserBasePo> getList(@Param("username") String username);
}

UserMapper.xml

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.example.code.mapper.UserMapper">

    <select id="getList" resultType="com.example.code.entity.UserBasePo">
        select *
        from user_base
        where username = #{name}
    </select>
</mapper>

MyTest 测试文件

@RunWith(SpringRunner.class)
@SpringBootTest
public class MyTest {

    @Resource
    private UserMapper userMapper;

    @Test
    public void myTest(){
        List<UserBasePo> list = userMapper.getList("zhow");
        list.forEach(System.out::println);
    }
}

数据库

SET NAMES utf8mb4;
SET FOREIGN_KEY_CHECKS = 0;

-- ----------------------------
-- Table structure for user_base
-- ----------------------------
DROP TABLE IF EXISTS `user_base`;
CREATE TABLE `user_base`  (
  `id` int(11) NOT NULL AUTO_INCREMENT,
  `username` varchar(255) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT NULL,
  `password` varchar(255) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT NULL,
  `realname` varchar(255) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT NULL,
  PRIMARY KEY (`id`) USING BTREE
) ENGINE = InnoDB AUTO_INCREMENT = 3 CHARACTER SET = utf8 COLLATE = utf8_general_ci ROW_FORMAT = Dynamic;

-- ----------------------------
-- Records of user_base
-- ----------------------------
INSERT INTO `user_base` VALUES (1, 'zhow', '123', '周帅傅');
INSERT INTO `user_base` VALUES (2, 'jy', '111', '金玉');

SET FOREIGN_KEY_CHECKS = 1;

修改前版本结果可以正常查询到数据

修改后版本报错

org.mybatis.spring.MyBatisSystemException: nested exception is org.apache.ibatis.binding.BindingException: Parameter 'name' not found. Available parameters are [param1, username]
//未找到参数“name”。可用参数为 [param1, username]

细心的小伙伴们一定会发现，mapper接口中写的参数是name但是xml中却写的是#{username}。

在不加入@Param注解的时候，如果只有一个参数，mybatis会直接匹配到#{}中，这就是之前为什么没有报错的原因。但是加上了@Param 就写死了只能使用对应参数的。结果就报错了。

小姐姐本来是要加一个mapper接口，结果看上面的接口都没有加@Param，就想着给他们都加一下，结果万万没有想到xml和接口上的参数名竟然不匹配。

关键是我记得我跟她聊天的时候看见她操作这块了，我还说没问题，心态爆炸，不能在小姐姐面前装大佬了！！！

总结

像是这种情况，我觉得最好的解决方法就是养成习惯，在mapper接口中对于所有参数都写@Param，防止出现这种坑。