如何用Visual Studio C++调试器调试JNI DLL？调试启动异常求助

问题描述 #

编写的JNI库直接运行java.exe时功能正常，C代码的printf输出可在控制台显示，但遇到以下调试问题：

• 通过Visual Studio 2022调试器启动java.exe时，调试器无法启动并抛出内部异常；仅运行不调试则正常
• 附加到独立运行的java.exe进程时，收到大量如下异常信息，且无后续反应：

  Exception thrown at 0x00007FFDA4CAB699 in java.exe: Microsoft C++ exception: JdsError<ipc::TimeoutExpiredError> at memory location 0x000000135E31F1C0
  

• 使用DLL的Debug配置，通过System.loadLibrary(...)加载库；尝试Oracle JDK 11、OpenJDK 11、JDK 22均出现相同问题，调试状态下Java的main()方法甚至未被调用

运行环境：

JRE version: Java(TM) SE Runtime Environment (22.0.2+9) (build 22.0.2+9-70)
Java VM: Java HotSpot(TM) 64-Bit Server VM (22.0.2+9-70, mixed mode, sharing, tiered, compressed oops, compressed class ptrs, g1 gc, windows-amd64)

解决方法 #

1. 忽略非致命调试异常 #

打开VS2022的调试→Windows→异常设置（快捷键Ctrl+Alt+E），在C++ Exceptions分类下取消勾选JdsError相关异常，或临时取消所有C++异常的勾选，让调试器跳过这类不影响程序运行的内部异常。也可在异常弹窗中勾选“不再显示此异常”。

2. 调整JNI库编译配置 #

• 切换DLL为Release配置后再调试，Debug版本JNI库可能与JVM调试机制存在兼容性冲突。
• 若必须使用Debug配置，确保编译运行库与JVM一致：右键项目→属性→配置属性→C/C++→代码生成→运行库，选择多线程调试 DLL (/MDd)。

3. 修正VS调试启动参数 #

在VS项目属性→配置属性→调试→命令参数中，确认传递给java.exe的参数完整：

• 指定主类完整包名（如com.example.Main）
• 正确设置-classpath参数指向编译后的Java类文件路径
• 可尝试添加JVM调试参数-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=5005，再通过VS附加到该端口，避免调试器与JVM内置调试代理冲突。

4. 排查JNI初始化逻辑 #

检查JNI_OnLoad函数中的Debug模式代码：

• 移除或优化耗时操作、避免死锁
• 替换printf为OutputDebugString，在VS输出窗口查看日志，避免控制台输出干扰调试器。

5. 修改JVM启动参数 #

启动java.exe时添加以下参数减少调试冲突：

• -Xnoagent：禁用JVM内置调试代理
• -Xshare:off：关闭类共享模式
• -Xdebug：启用基础调试模式（部分场景可缓解冲突）

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