signature属性是jvm标准属性,用于在.class文件中存储泛型类型签名,分别位于类、字段、方法的attributes表中,其内容为指向常量池utf-8项的索引,实际签名按jvm类型签名语法编码,支持反射获取泛型信息。

泛型信息在 Java 的 .class 文件中并不直接保留在类、方法或字段的常规结构里,而是通过一个名为 Signature 的可选属性(Attribute)来存储。该属性属于 JVM 规范定义的标准属性之一,用于在字节码层面保留泛型相关的类型签名(type signature),以便运行时反射或工具(如 IDE、序列化框架)能还原泛型类型信息。
Signature 属性的出现位置
Signature 属性可以出现在以下三种结构的属性表(attributes table)中:
- 类文件的 ClassFile.attributes(对应类本身的泛型声明,如
class Box<t extends number></t>) - 字段表项(field_info.attributes)(对应泛型字段,如
private List<string> items;</string>) - 方法表项(method_info.attributes)(对应泛型方法或带泛型参数/返回值的方法,如
<k> Map<k> createMap()</k></k>)
Signature 属性的二进制格式
每个 Signature 属性在字节码中按如下结构组织:
-
u2 attribute_name_index:指向常量池中字符串
"Signature"的索引 - u4 attribute_length:属性内容长度(不包括 name_index 和 length 字段)
-
u2 signature_index:指向常量池中
CONSTANT_Utf8_info项的索引,该 UTF-8 项存储的是**类型签名字符串**(Type Signature String)
注意:Signature 属性本身不包含签名文本,只提供一个索引;实际签名以 JVM 类型签名语法(JVM Type Signatures)编码,保存在常量池的 UTF-8 条目中。
类型签名字符串的语法规则
签名字符串不是 Java 源码中的泛型写法,而是 JVM 定义的一套紧凑编码,区分原始类型、引用类型、泛型参数、通配符、类型边界等。常见示例:
-
List<string></string>→Ljava/util/List<ljava>;</ljava> -
Map<integer extends charsequence></integer>→Ljava/util/Map<ljava>;</ljava> -
<t extends comparable>> T get()</t>(方法签名)→<ljava>>TT;</ljava> - 类声明
class Pair<k></k>→<ljava></ljava>
其中:T 表示类型变量,+ 表示上界通配符(? extends),- 表示下界(? super),<...></...> 包裹类型参数声明或参数化类型,TT; 是对类型变量 T 的引用(末尾分号不可省)。
Signature 属性与类型擦除的关系
Java 泛型是编译期特性,运行时发生类型擦除。但 Signature 属性是编译器(如 javac)主动写入 class 文件的额外元数据,它不参与运行时类型检查或强制转换,仅作为“提示信息”供反射 API(如 Field.getGenericType()、Method.getTypeParameters())读取。若 class 文件未携带 Signature 属性(如由某些非标准编译器生成,或被字节码工具剥离),则反射将无法获取泛型信息,退化为原始类型。









