使用MapStruct处理一对多与多对一映射时，避免循环引用同时获取关联用户信息的实现问题

看起来你遇到了MapStruct里双向关联映射的经典循环引用问题——既要避免StackOverflow异常，又想保留Reservation里的用户关键信息（比如userId），对吧？我来给你几个可行的方案，结合你的代码来调整：

方案一：直接在映射时指定关联对象的必要字段（最简洁） #

你之前直接用@Mapping(target = "user", ignore = true)把整个User对象都忽略了，其实完全不用这么极端。我们可以只映射User里需要的核心字段（比如userId、姓名、邮箱），同时在User的Mapper里继续忽略Reservations集合，这样就能截断循环引用链。

修改你的ReservationsEntityMapper：

@Mapper(componentModel = "spring", unmappedTargetPolicy = ReportingPolicy.IGNORE, uses = UsersEntityMapper.class)
public interface ReservationsEntityMapper {

    // 从Business层Reservations转Entity时，依赖UsersEntityMapper完成User到FlightAppUsersEntity的映射（已经忽略reservations）
    @Mapping(target = "user", source = "user")
    ReservationsEntity mapToEntity(Reservations business);

    // 从Entity转Business层Reservations时，只映射User的必要字段，跳过循环关联的reservations
    @Mapping(target = "user.userId", source = "user.userId")
    @Mapping(target = "user.firstName", source = "user.firstName")
    @Mapping(target = "user.lastName", source = "user.lastName")
    @Mapping(target = "user.email", source = "user.email")
    // 其他不需要的User字段交给unmappedTargetPolicy自动忽略
    Reservations mapFromEntity(ReservationsEntity entity);
}

你的UsersEntityMapper保持原有配置即可，继续忽略reservations字段截断循环：

@Mapper(componentModel = "spring", unmappedTargetPolicy = ReportingPolicy.IGNORE)
public interface UsersEntityMapper {
    @Mapping(target = "reservations", ignore = true)
    User mapFromEntity(FlightAppUsersEntity entity);

    @Mapping(target = "reservations", ignore = true)
    FlightAppUsersEntity mapToEntity(User user);
}

这种方式的核心是：只映射关联对象的必要字段，而不是整个对象，同时在关联的另一端截断循环引用，既避免了StackOverflow，又保留了你需要的用户信息。

方案二：使用@AfterMapping手动补全关联信息（适合复杂业务场景） #

如果需要自定义逻辑控制（比如根据条件决定是否映射用户信息），可以用@AfterMapping手动补全User的核心字段：

修改ReservationsEntityMapper：

@Mapper(componentModel = "spring", unmappedTargetPolicy = ReportingPolicy.IGNORE)
public interface ReservationsEntityMapper {

    // 先忽略整个user字段
    @Mapping(target = "user", ignore = true)
    Reservations mapFromEntity(ReservationsEntity entity);

    // 手动补全用户核心信息，刻意跳过reservations集合避免循环
    @AfterMapping
    default void fillUserInfo(ReservationsEntity entity, @MappingTarget Reservations business) {
        if (entity.getUser() != null) {
            User user = User.builder()
                    .userId(entity.getUser().getUserId())
                    .firstName(entity.getUser().getFirstName())
                    .lastName(entity.getUser().getLastName())
                    .email(entity.getUser().getEmail())
                    // 绝对不要设置reservations字段
                    .build();
            business = business.withUser(user);
        }
    }

    // 转Entity的方法保持正常逻辑
    @Mapping(target = "user", source = "user")
    ReservationsEntity mapToEntity(Reservations business);
}

这种方式的优势是灵活性极高，你可以加入任意业务判断逻辑，比如仅在用户状态为活跃时才映射用户信息。

方案三：调整DTO层结构（从根源避免循环） #

如果前端不需要完整的User对象，完全可以在ReservationsDTO里直接存储用户的核心字段，而不是嵌套UserDTO，彻底从数据结构层面避免循环：

修改ReservationsDTO：

@Value
@With
@Builder
@EqualsAndHashCode(of = "reservationId")
public class ReservationsDTO {
    Integer reservationId;
    // 其他预订相关字段
    Integer userId;
    String userFirstName;
    String userLastName;
    String userEmail;
}

对应的ReservationsMapper可以简化为：

@Mapper(componentModel = "spring")
public interface ReservationsMapper {
    @Mapping(target = "userId", source = "user.userId")
    @Mapping(target = "userFirstName", source = "user.firstName")
    @Mapping(target = "userLastName", source = "user.lastName")
    @Mapping(target = "userEmail", source = "user.email")
    ReservationsDTO map(final Reservations reservations);
}

这种方式不仅解决了循环问题，还能减少前端的数据传输量，适合不需要完整用户对象的场景。

备注：内容来源于stack exchange，提问作者kukovsky