动态挂载JVMTI代理GetClassMethods返回类未准备错误如何解决

问题根因 #

• 动态挂载代理时JVM已完成启动，大量仅加载未实际使用的类停留在已加载未准备状态。ClassPrepare事件仅在类首次进入准备阶段时触发，你挂载代理后注册的回调只能捕获到后续新加载类的准备事件，因此触发量极少。
• GetClassMethods接口要求目标类完成准备阶段才能调用成功，未准备的类调用时会返回JVMTI_ERROR_CLASS_NOT_PREPARED错误。

可行解决方案 #

你可以通过以下步骤主动触发已加载未准备类完成准备流程：

1. 提前检查类准备状态
   调用GetClassStatus接口先判断类是否已经完成准备，避免无意义的操作：

jint status;
jvmtiError err = (*jvmti)->GetClassStatus(jvmti, klass, &status);
if (err == JVMTI_ERROR_NONE && (status & JVMTI_CLASS_STATUS_PREPARED) != 0) {
    // 类已准备，可直接调用GetClassMethods
    (*jvmti)->GetClassMethods(jvmti, klass, &method_count, &methods);
} else {
    // 未准备，进入触发准备流程
}

2. 主动触发类准备
   对未准备的类，先获取类签名转换为全限定名，再通过JNI的FindClass接口触发JVM自动完成类的准备流程：

// 第一步：获取类签名并转换为FindClass要求的格式
char *sig_ptr;
(*jvmti)->GetClassSignature(jvmti, klass, &sig_ptr, NULL);
char class_name[1024] = {0};
size_t sig_len = strlen(sig_ptr);
// 普通对象类签名格式为Lxxx/yyy/zzz;，需要去掉首尾的L和分号
if (sig_ptr[0] == 'L' && sig_ptr[sig_len-1] == ';') {
    strncpy(class_name, sig_ptr + 1, sig_len - 2);
} else {
    // 数组、原始类型类直接使用原签名
    strcpy(class_name, sig_ptr);
}
(*jvmti)->Deallocate(jvmti, (unsigned char*)sig_ptr);

// 第二步：调用FindClass触发类准备
JNIEnv *env;
(*jvm)->GetEnv(jvm, (void**)&env, JNI_VERSION_11);
jclass prepared_klass = (*env)->FindClass(env, class_name);
if (prepared_klass != NULL) {
    // 此时类已完成准备，可正常调用GetClassMethods
    (*jvmti)->GetClassMethods(jvmti, prepared_klass, &method_count, &methods);
    (*env)->DeleteLocalRef(env, prepared_klass);
}

3. 注意事项

• 数组类、原始类型类不需要额外准备，调用GetClassStatus会直接返回已准备状态。
• 部分存在依赖冲突的类可能触发准备失败，需要补充对应的错误处理逻辑。
• 主动触发类准备会附带执行类的初始化逻辑（若之前未执行），可能对业务进程运行状态产生轻微影响，需根据使用场景评估风险。

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