Java8中package-info类出现“注解类型不适用于此类声明”编译错误

问题根源 #

Java 8的编译器对注解的**适用目标（@Target）**校验比Java 6/7更严格。@NamedNativeQueries和@SqlResultSetMappings的注解目标被定义为ElementType.TYPE，仅允许作用在类、接口或枚举上，不能直接用于package级别声明。而Java 6/7的编译器未严格执行这一限制，导致代码在旧版本可编译，但Java 8中触发错误。

修复方案 #

1. 将注解迁移至实体类 #

这类命名查询和结果集映射本质上与实体类关联，将注解移到对应的实体类上是符合JPA规范的正确做法：

import javax.persistence.Entity;
import javax.persistence.NamedNativeQueries;
import javax.persistence.NamedNativeQuery;
import javax.persistence.SqlResultSetMappings;

@Entity
@NamedNativeQueries({
    @NamedNativeQuery(name = "",
        query = "",
        resultSetMapping = "mapping"
    ),
    @NamedNativeQuery(
         name = "",
         query = "",
         callable = true,
         readOnly = false,
         resultSetMapping = ""
    )
})
@SqlResultSetMappings({
    // 在这里定义你的结果集映射规则
})
public class YourEntity {
    // 实体类字段及方法
}

2. 修正代码中的语法错误 #

你提供的代码里第二个NamedNativeQuery漏掉了@符号，这会导致额外的编译问题，需要补充为@NamedNativeQuery。

总结 #

Java 8严格遵循注解的目标定义，禁止将@NamedNativeQueries、@SqlResultSetMappings这类TYPE级别的注解用于package声明。将注解迁移到实体类即可解决编译错误，同时也更符合JPA的设计逻辑。

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