开发Java Agent库遇JVM无法找到Agent_OnLoad函数问题求助

常见原因及解决方案 #

1. 避免C++名称修饰问题 #

C++编译器会对函数名进行名称修饰（Name Mangling），导致JVM无法识别原本的Agent_OnLoad函数名。必须用extern "C"包裹函数，强制使用C语言的无修饰命名规则：

extern "C" JNIEXPORT jint JNICALL
Agent_OnLoad(JavaVM* vm, char* options, void* reserved)
{
    return JNI_OK;
}

2. 确认函数已被正确导出 #

使用Visual Studio自带的dumpbin工具检查DLL的导出表，确认Agent_OnLoad存在：

dumpbin /exports FuncTest.dll

如果输出中没有Agent_OnLoad条目，说明函数未被成功导出，需检查编译设置。

3. 调整Visual Studio项目设置 #

• 编译语言设置：右键项目 → 属性 → 配置属性 → C/C++ → 高级 → 编译为，选择编译为C代码(/TC)（适合纯C实现的Agent）；若要保留C++代码，务必保留extern "C"修饰。
• 平台位数匹配：Corretto 17默认是64位版本，需确保VS项目的平台设置为x64；如果使用32位JVM，项目需切换为x86，位数不匹配会导致JVM无法加载函数。

4. 验证函数签名正确性 #

Agent_OnLoad的签名必须严格匹配JNI规范：

• 返回值：jint
• 参数：JavaVM* vm, char* options, void* reserved
  参数类型（如char*不能替换为const char*）或顺序错误，都会导致JVM无法识别该函数。

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