JPA QuerySyntaxException异常求助：Player类未映射问题排查

这个问题我之前也碰到过，核心原因是你的persistence.xml里没有显式声明要加载的实体类，导致JPA容器无法识别到Player这个实体映射，自然就会抛出“未映射”的异常。

第一步：修复persistence.xml配置 #

在<persistence-unit>标签内，添加<class>元素，指定Player类的全限定类名（包名+类名），示例如下：

<?xml version="1.0" encoding="UTF-8"?>
<persistence version="2.1" xmlns="http://xmlns.jcp.org/xml/ns/persistence" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/persistence http://xmlns.jcp.org/xml/ns/persistence/persistence_2_1.xsd">
  <persistence-unit name="testMicroProfile" transaction-type="RESOURCE_LOCAL">
    <!-- 新增这行，替换成你实际的包名 -->
    <class>com.yourpackage.Player</class>
    <properties>
      <property name="javax.persistence.jdbc.url" value="jdbc:postgresql://localhost:5432/microprofiledb"/>
      <property name="javax.persistence.jdbc.driver" value="org.postgresql.Driver"/>
      <property name="javax.persistence.jdbc.user" value="user"/>
      <property name="javax.persistence.jdbc.password" value="psw"/>
    </properties>
  </persistence-unit>
</persistence>

为什么要加这个？ #

当transaction-type设置为RESOURCE_LOCAL时，很多JPA实现（比如Hibernate）不会自动扫描类路径下的实体类，必须通过<class>标签显式告诉容器要加载哪些实体。

第二步：优化你的代码（可选但推荐） #

你的代码里有两个可以优化的点：

1. 不要每次请求都创建EntityManagerFactory：Persistence.createEntityManagerFactory()是非常重的操作，应该全局只创建一次，比如通过依赖注入或者单例模式。
2. 只读查询不需要开启事务：你的查询是只读操作，完全不需要开启和提交事务，直接执行即可。

优化后的主类示例：

@ApplicationScoped
@Path("/hello2")
public class HelloWorld extends Application {

    // 注入EntityManager，MicroProfile会自动管理它的生命周期
    @Inject
    private EntityManager entityManager;

    @Path("/players")
    @GET
    @Produces(MediaType.APPLICATION_JSON) // 记得添加这个，否则返回的List可能无法序列化
    public List<Player> getPlayers() {
        TypedQuery<Player> query = entityManager.createQuery("SELECT p FROM Player p", Player.class);
        return query.getResultList();
    }
}

同时，如果你使用MicroProfile的话，建议把persistence.xml的transaction-type改成JTA，这样可以更好地利用容器的事务管理能力，也能避免手动创建EntityManager的麻烦。

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