别再写 setter 了！MapStruct Plus vs MapStruct，谁才是 Bean 转换的真神？

原创于 2026-07-28 09:34:32 发布 · 176 阅读

5 ·

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

收录于

朝花夕拾篇

01 引言

日常开发中，我们经常会遇到对象转化的问题。尤其阿里提出了DTO、BO、VO、PO的概念之后，对于转化的场景更多。

转化的工具也不少，BeanUtils、MapStruct、Orika等工具层出不穷，每个人或者团队的选择也大不相同。

02 三大流派

Java 生态里"对象转对象"这件事大致分为桑哥流派。

2.1 手写派

new 一个对象，然后 setter 挨个赋值。这个是最简单，最常用的手段。但是字段多的话，就会角色很繁琐。

UserDTO dto = new UserDTO();
dto.setId(user.getId());
dto.setName(user.getName());
dto.setAge(user.getAge());
dto.setEmail(user.getEmail());
dto.setPhone(user.getPhone());
dto.setCreateTime(user.getCreateTime());
// ... 30 行 setter
return dto;

但是，AI时代，AI提示工具会帮我们直接联想关联，也省了不少功夫，但是代码量不会变。

优缺点：

优点：性能拉满，可读性尚可。
缺点：字段超过 10 个就开始怀疑人生，字段名修改需要联动修改。

2.2 反射派

反射的工具类代表：Spring BeanUtils、Apache Commons BeanUtils、Hutool BeanUtil。

BeanUtils.copyProperties(source, target);

使用工具类是最省事情的，但是不同的工具参数以及最终的结构都少有差异。如果字段的类型不一致，还可能出现转化失败。最关键的，性能也是最差的。

优缺点：

优点：一行代码搞定，懒人福音。
缺点：运行时反射，性能是硬伤；还不做类型检查，int 字段和 String 字段同名也能给你"成功"转过去——数据错了你都不知道怎么错的。

2.3 编译期生成派

代表：MapStruct、MapStruct Plus。

就是在在你 javac 编译的时候，APT（注解处理器）自动生成转换代码，运行时压根没反射。运行效果同Setter方法。

这也是今天我们要介绍的重点工具。

03 MapStruct

3.1 简介

MapStruct 是 Java 圈做 Bean 映射的事实标准，Apache-2.0 协议，GitHub 上7.7k颗 star，背后有一整个组织在维护。最新稳定版 1.6.3。

官网：https://mapstruct.org

GitHub地址：https://github.com/mapstruct/mapstruct

3.2 使用

使用也是非常简单。

Maven依赖

...
<properties>
    <org.mapstruct.version>1.6.3</org.mapstruct.version>
</properties>
...
<dependencies>
    <dependency>
        <groupId>org.mapstruct</groupId>
        <artifactId>mapstruct</artifactId>
        <version>${org.mapstruct.version}</version>
    </dependency>
</dependencies>
...
<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.8.1</version>
            <configuration>
                <source>1.8</source>
                <target>1.8</target>
                <annotationProcessorPaths>
                    <path>
                        <groupId>org.mapstruct</groupId>
                        <artifactId>mapstruct-processor</artifactId>
                        <version>${org.mapstruct.version}</version>
                    </path>
                </annotationProcessorPaths>
            </configuration>
        </plugin>
    </plugins>
</build>
...

定义转化接口

@Mapper(componentModel = MappingConstants.ComponentModel.SPRING)
public interface UserMapper {

    UserVO userDtoToVO(UserDTO userDto);
}

这里使用Spring实例模式，定义的方法上可以通过@Mapping(target = "a", source = "b")定制处理不同的字段的映射。

maven 配置annotation processor，编译的时候它就给你生成一个 UserMapperImpl.java，里面全是规规矩矩的 target.setXxx(source.getXxx())。

调用

3.3 缺点

这玩意儿最大的问题：烦。

每对类型转换，你都要写一个 @Mapper 接口。如果你项目里 50 个 DTO，那就是 50 个 Converter 类。直接类爆炸！

04 MapStruct Plus

国产"外挂"来了，顾名思义就是MapStruct的加强版。

4.1 简介

Mapstruct Plus 是 Mapstruct 的增强工具，在 Mapstruct 的基础上，实现了自动生成 Mapper 接口的功能，并强化了部分功能，使 Java 类型转换更加便捷、优雅。

可能是最简单最强大的Java Bean转换工具。

Mapstruct Plus所解决的痛点正式取消了定义转化的接口，取而代之的是注解。

官网地址：https://www.mapstruct.plus/

GitHub地址：https://github.com/linpeilie/mapstruct-plus

4.2 使用

Maven依赖

<properties>
    <mapstruct-plus.version>latest version</mapstruct-plus.version>
</properties>
<dependencies>
    <dependency>
        <groupId>io.github.linpeilie</groupId>
        <artifactId>mapstruct-plus-spring-boot-starter</artifactId>
        <version>${mapstruct-plus.version}</version>
    </dependency>
</dependencies>
<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.8.1</version>
            <configuration>
                <source>1.8</source>
                <target>1.8</target>
                <annotationProcessorPaths>
                    <path>
                        <groupId>io.github.linpeilie</groupId>
                        <artifactId>mapstruct-plus-processor</artifactId>
                        <version>${mapstruct-plus.version}</version>
                    </path>
                </annotationProcessorPaths>
            </configuration>
        </plugin>
    </plugins>
</build>

定义实体

@Data
@AllArgsConstructor
@NoArgsConstructor
@AutoMapper(target = UserVO.class)
public class UserDTO {
    /**  用户ID */
    private Integer id;
    /**  用户名 */
    private String name;
    /**  出生日期 */
    private Date birthday;
    /**  电话号码 */
    private String phone;
}