Spring Boot JPA多对多查询报错：Unknown label 'name' 求助

问题现象 #

Postman调用接口返回500错误：

"error": "Internal Server Error",
"message": "Unable to find column position by name: name",

控制台抛出异常：

java.sql.SQLException: Unknown label 'name'. Possible value [song_album.genre, year, genre, song_album.year, type, song_album.song_album_id, song_album.type, song_album_id]

错误原因 #

1. 实体映射字段缺失：SongAlbum实体类包含name属性，但你在原生SQL查询中没有选择song_album.name字段，JPA将查询结果映射到SongAlbum实体时找不到对应字段，触发报错。
2. 多对多关联未正确加载：当前原生SQL仅做了表关联查询，但无法自动将艺术家数据映射到SongAlbum的artistList集合，无法实现"查询歌曲及对应艺术家名称"的需求。

解决方案 #

方案一：修复原生SQL（仅解决字段缺失，无法自动加载关联）

修改SongAlbumRepository的查询语句，补充缺失的song_album.name字段：

@Query(value= "select song_album.song_album_id, song_album.name, song_album.genre, song_album.`type`, song_album.`year` from song_album_artist join artist on song_album_artist.cnp = artist.cnp join song_album on song_album_artist.song_id = song_album.song_album_id", nativeQuery = true)
List<SongAlbum> findSongsWithArtists();

注意：此方案仅能解决字段缺失报错，但无法自动填充artistList集合，不推荐用于多对多关联查询场景。

方案二：使用JPQL自动处理多对多关联（推荐）

替换原生SQL为JPQL，利用JPA自动加载关联实体：

@Query("SELECT DISTINCT sa FROM SongAlbum sa JOIN FETCH sa.artistList")
List<SongAlbum> findSongsWithArtists();

• DISTINCT：避免多对多关联导致的重复SongAlbum结果
• JOIN FETCH：强制立即加载关联的artistList集合，确保返回的每个歌曲对象都包含对应的艺术家列表（包括名称）

额外注意事项 #

• 解决JSON循环引用：多对多双向关联会导致序列化时栈溢出，需在其中一方的关联字段添加@JsonIgnore，例如在SongAlbum的artistList上添加该注解。
• 数据库表名大小写：确认数据库表名（如SongAlbumArtist和SQL中的song_album_artist）是否匹配，若数据库大小写敏感需统一命名规则。

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