MyBatis映射错误：'dto'属性无getter方法解析-牛站云

MyBatis项目开发过程中，映射错误是比较常见的问题，其中“'dto'属性无getter方法”属于一类容易让开发者困惑的异常。该问题通常发生在Mapper XML文件配置、Java实体类属性定义、MyBatis参数映射方式之间存在不匹配时。理解错误产生的原因，并掌握正确排查方法，可以有效提高开发效率。

一、错误现象分析

当MyBatis执行SQL映射时，如果出现类似以下异常：


There is no getter for property named 'dto' in class xxx

或者：


org.apache.ibatis.reflection.ReflectionException:
There is no getter for property named 'dto' in class 'xxx'

表示MyBatis尝试从某个Java对象中获取名为dto的属性，但是通过反射机制没有找到对应的getter方法。

MyBatis底层依赖Java Bean规范访问对象属性。例如：

Java
public class UserDTO {

    private String username;

}

MyBatis查找username属性时，会寻找：

Java
public String getUsername()

如果不存在这个方法，就会认为该属性不存在。

因此，“dto无getter方法”并不一定表示DTO类真的没有getter，而是MyBatis当前解析的对象类型中不存在名为dto的属性。

二、常见错误原因

1. Mapper参数名称配置错误

这是最常见的情况。

例如Mapper接口：

Java
List<User> selectUser(UserDTO userDTO);

XML配置：

XML
 id="selectUser" resultType="User">
    SELECT *
    FROM user
    WHERE username = #{dto.username}

执行时，MyBatis会认为传入参数对象中存在：

Java
userDTO.getDto()

然后继续调用：

Java
getUsername()

但是实际上参数对象只有：

Java
getUsername()

并没有：

Java
getDto()

所以出现异常。

正确写法：

XML
 id="selectUser" resultType="User">
    SELECT *
    FROM user
    WHERE username = #{username}

或者明确指定参数名称：

Java
List<User> selectUser(@Param("dto") UserDTO dto);

此时XML：

XML
 id="selectUser" resultType="User">
    SELECT *
    FROM user
    WHERE username = #{dto.username}

才是正确的。

三、理解MyBatis参数解析机制

很多开发者误认为：

Java
select(UserDTO dto)

中的变量名就是MyBatis可以直接使用的名称。

实际上并非如此。

如果没有使用@Param：

Java
List<User> find(UserDTO dto);

MyBatis默认参数名称可能是：


arg0
param1

或者：


param1

具体取决于配置和编译参数。

因此XML：

XML
#{dto.username}

并不能保证能够找到对应对象。

推荐方式：

Java
List<User> find(@Param("dto") UserDTO dto);

XML：

XML
#{dto.username}

这样参数关系明确，可读性也更好。

四、DTO缺少getter导致的问题

另一种情况是真正的DTO类没有getter方法。

例如：

Java
public class UserDTO {

    private String username;

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

该类只有setter，没有getter。

MyBatis执行：

XML
#{username}

时，会尝试调用：

Java
getUsername()

但是不存在，因此报错。

解决方式：

方法一：手动添加getter

Java
public String getUsername(){
    return username;
}

方法二：使用Lombok生成getter

项目中经常使用Lombok：

Java
@Data
public class UserDTO {

    private String username;

}

@Data会自动生成：

getter
setter
equals
hashCode
toString

如果使用：

Java
@Getter
@Setter
public class UserDTO {

    private String username;

}

也可以满足MyBatis需求。

需要注意的是，如果IDE显示有getter，但实际编译后的class没有生成，也可能导致类似问题，需要检查Lombok依赖是否正常。

五、resultMap中的dto属性错误

除了参数映射，返回结果映射也可能触发该异常。

例如：

XML
 id="userMap" type="UserVO">

     property="dto"
                 javaType="UserDTO">
         property="username"
                column="username"/>

MyBatis会要求：

Java
UserVO

中存在：

Java
private UserDTO dto;

并且有：

Java
public UserDTO getDto()

如果没有：

Java
getDto()

就会出现：


There is no getter for property named 'dto'

检查对应类：

Java
public class UserVO {

    private UserDTO dto;

}

需要补充：

Java
public UserDTO getDto(){
    return dto;
}

或者使用：

Java
@Getter
@Setter
public class UserVO {

    private UserDTO dto;

}

六、MyBatis动态SQL中的错误写法

动态SQL中也容易出现类似问题。

错误示例：

XML
 test="dto.username != null">
    AND username = #{dto.username}

但是Mapper：

Java
List<User> query(UserDTO userDTO);

没有：

Java
@Param("dto")

那么MyBatis无法识别dto。

修改：

Java
List<User> query(@Param("dto") UserDTO userDTO);

或者：

XML
 test="username != null">
    AND username = #{username}

七、多参数情况下容易出现的问题

例如：

Java
User selectUser(
    UserDTO dto,
    Integer status
);

XML：

XML
WHERE username=#{dto.username}
AND status=#{status}

这种写法可能导致问题。

八、排查错误的步骤

遇到“dto属性无getter方法”问题，可以按照以下顺序排查。

1. 查看异常中的完整类名

异常通常会显示：


in class 'xxx'

确认MyBatis正在操作哪个对象。

如果提示：


class UserDTO

说明它正在UserDTO中寻找：

Java
getDto()

如果提示：


class UserVO

说明问题可能出现在返回对象。

2. 检查XML中的dto引用

搜索：

XML
#{dto.xxx}

或者：

XML
test="dto.xxx"

确认Mapper参数是否真的叫dto。

3. 检查Mapper接口参数

确认是否：

Java
@Param("dto")

例如：

Java
User select(@Param("dto") UserDTO dto);

4. 检查实体类getter

确认：

Java
public Xxx getDto()

是否存在。

如果使用Lombok，检查：

Lombok插件是否安装
Maven依赖是否存在
编译是否成功

九、推荐的MyBatis DTO设计方式

为了减少映射问题，项目中建议统一规范。

DTO：

Java
@Data
public class UserQueryDTO {

    private String username;

    private Integer age;

}

Mapper：

Java
List<User> selectUser(
    @Param("dto") UserQueryDTO dto
);

XML：

XML
 id="selectUser"
        resultType="User">

    SELECT *
    FROM user

    

         test="dto.username != null">
            AND username=#{dto.username}
        

         test="dto.age != null">
            AND age=#{dto.age}