MapStruct嵌套DTO映射异常：UserDto中SongDto字段返回Null

以下是针对该问题的排查方向和解决办法：

1. 检查UserMapper是否关联了PlaylistMapper #

MapStruct不会自动跨Mapper触发嵌套映射，如果你只定义了UserMapper中User转UserDto的方法，但没有显式关联能正确转换Playlist到PlaylistDto的PlaylistMapper，MapStruct只会对playlists做简单的属性拷贝，不会触发深层的songs转换。

解决办法：
在UserMapper上通过uses属性指定依赖的PlaylistMapper，让MapStruct在处理playlists时调用正确的映射逻辑：

@Mapper(componentModel = "spring", uses = {PlaylistMapper.class})
public interface UserMapper {
    UserDto toDto(User user);
}

2. 排查JPA懒加载导致的数据未加载 #

单独转换Playlist时，你可能通过查询或业务逻辑触发了songs的加载（比如用了JOIN FETCH或者主动调用了集合方法），但查询User时，只加载了User和Playlist的关联，Playlist的songs还是JPA的懒加载代理对象，MapStruct无法获取实际数据，最终导致songsDto为null。

解决办法：

• 在查询User的JPQL中添加多层JOIN FETCH，确保一次性加载所有关联数据：

@Query("SELECT u FROM User u JOIN FETCH u.playlists p JOIN FETCH p.songs WHERE u.id = :userId")
User findUserWithPlaylistsAndSongs(@Param("userId") Long userId);

• 避免直接将fetch = FetchType.EAGER设置在多对多关联上，这会导致查询性能下降。

3. 检查是否存在错误的映射忽略配置 #

如果UserMapper中对playlists的嵌套属性做了自定义映射，不小心忽略了songsDto字段，也会导致该值为null。

解决办法：
检查UserMapper的@Mapping注解，确保没有类似如下的配置：

@Mapping(target = "playlists.songsDto", ignore = true)
UserDto toDto(User user);

如果有，直接删除该配置即可。

4. 尝试升级MapStruct版本 #

旧版本的MapStruct在处理多层嵌套关联映射时存在已知bug，可能导致深层映射不生效。

解决办法：
将MapStruct升级到最新稳定版本（比如1.5.5.Final），更新你的依赖配置：

<!-- Maven依赖示例 -->
<dependency>
    <groupId>org.mapstruct</groupId>
    <artifactId>mapstruct</artifactId>
    <version>1.5.5.Final</version>
</dependency>
<dependency>
    <groupId>org.mapstruct</groupId>
    <artifactId>mapstruct-processor</artifactId>
    <version>1.5.5.Final</version>
    <scope>provided</scope>
</dependency>

内容的提问来源于stack exchange，提问作者humblefool