@documentId如果您使用的是老式的样式来映射实体和
.hbm.xml文件，则必须使用。如果您使用该映射方法而忽略了对文档ID的注释，那么在启动时，您将看到如下异常：
org.hibernate.search.SearchException: No document id in: com.mypackage.MyEntity
但是，如果您使用的是注释，并使用注释了主键
@Id，则不必使用
@documentId。
更准确地说，Hibernate Search文档说这
@documentId在使用 JPA
注释时是可选的。因此，
@documentId如果您正在使用Hibernate 3.x样式的注释，也许您仍需要使用…我从未测试过。
无论哪种方式， 即使 您在查询中使用的是Hibernate
Session而不是JPA ，Hibernate
4.x都会弃用自己的映射注释，而使用JPA样式的注释
EntityManager。简而言之：
@documentId如果您正在使用XML样式的映射，则需要使用…，而如果您使用的是注释，则是可选的，因为此时您仍应使用JPA样式的注释。
