Spring JPA中Postgres多对多关系下如何按tag_id查询所有帖子

你的代码存在三处错误，修正后即可正常运行：

• 字段名不匹配：根据给出的表结构，中间关联表post_tag关联帖子的外键列为id_post，并非你SQL中写的post_id
• 参数未绑定：原生SQL中直接写id会被数据库解析为表自身的字段，不会映射到方法传入的参数，需要通过位置参数或具名参数显式绑定
• 返回值不合理：使用Optional包裹集合类型是JPA常见误用，无匹配数据时JPA会返回空列表，无需额外用Optional包装集合。

1. 原生SQL修正版 #

直接修正字段名和参数绑定即可，和你在pgAdmin中执行的逻辑完全一致：

import org.springframework.data.jpa.repository.Query
import org.springframework.data.repository.CrudRepository

interface PostRepository : CrudRepository<Post, String> {
    // 位置参数绑定写法
    @Query(
        value = "SELECT * FROM post WHERE id IN (SELECT id_post FROM post_tag WHERE id_tag = ?1)",
        nativeQuery = true
    )
    fun findPostsByTagId(id: String): List<Post>
}

如果偏好具名参数，可以配合@Param注解使用：

import org.springframework.data.repository.query.Param

@Query(
    value = "SELECT * FROM post WHERE id IN (SELECT id_post FROM post_tag WHERE id_tag = :tagId)",
    nativeQuery = true
)
fun findPostsByTagId(@Param("tagId") id: String): List<Post>

2. 实体关联优化版（推荐） #

如果你已经在Post、Tag实体类上配置了@ManyToMany多对多关联关系，不需要手写原生SQL，直接使用JPQL即可，JPA会自动根据实体关联配置拼接中间表查询逻辑，不需要手动维护中间表字段名：

@Query("SELECT p FROM Post p JOIN p.tags t WHERE t.id = ?1")
fun findPostsByTagId(id: String): List<Post>

这种写法兼容性更好，后续如果调整中间表字段名，只需要修改实体的关联注解配置，不需要修改Repository层的查询代码。

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