如何追踪Java遍历CLASSPATH加载类时实际尝试访问的文件路径

你记忆中早年Java版本带的类搜索路径日志参数并未被移除，Java 5之后这类深度诊断参数被归类到-XX隐藏参数体系，不会出现在java -X的公开选项列表中，所以逐一测试-X参数找不到对应功能。

一、Java内置日志参数（优先使用） #

• 核心路径追踪参数：启动Java时追加-XX:+TraceClassPaths，该参数会完整输出类加载过程中所有被扫描的类路径条目、每个类/资源查找时遍历的实际文件路径、以及所有尝试访问但未找到的目标资源路径，完全匹配你早年用来定位CLASSPATH问题的日志能力。
• 补充验证参数：搭配追加-verbose:class，可输出每个类最终加载成功的来源路径，和上面的参数组合即可100%还原类加载阶段的全量路径访问记录。
• 注意：上述参数是Java 8的专属诊断参数，不需要加额外依赖，直接追加到启动命令的JVM参数位置即可生效。

二、系统层面追踪方案（内置参数无法定位时使用） #

• Windows侧：使用微软官方提供的进程监控工具，筛选对应java.exe进程的文件创建、目录查询操作，即可看到Java进程发起的每一次文件系统访问的完整路径、以及访问结果（成功/文件不存在/权限不足），可以直接定位到JVM实际尝试访问的错误路径。
• Cygwin侧：在Cygwin终端中，在原有启动命令前加strace -f -e file执行，可追踪C启动程序调用Windows API创建Java进程时的全量文件操作、以及对传入参数、环境变量的路径转换逻辑，排查是否是Cygwin的自动路径转换机制篡改了CLASSPATH值。

三、针对当前故障场景的高频排查点 #

结合你描述的「进入lib目录指定-cp .可正常运行、配置绝对路径失败」的现象，优先排查以下问题：

• Cygwin路径自动转换异常：新版Cygwin默认会对传入Windows原生程序的参数、环境变量做类Unix路径到Windows路径的自动改写，你配置的C:/opt/OurInstallationDir/lib格式路径可能被误识别为Cygwin路径，被错误拼接前缀或改写分隔符后传给Java，导致路径失效。可以在C启动程序调用CreateProcess启动Java前，加一行日志打印实际传入的CLASSPATH值做初步校验。
• Windows 10目录权限限制：Windows 10默认对C盘根目录下的用户自建目录开启UAC权限管控，即使路径完全正确，如果运行Java的用户没有目标lib目录的列目录、读取权限，类加载器扫描路径时会直接失败，表现和路径不存在完全一致。
• 路径格式误用：Windows原生的java.exe本身支持正斜杠作为路径分隔符，不需要将路径改为反斜杠格式；注意不要使用/cygdrive/c/前缀的路径，该格式仅Cygwin程序可识别，Windows原生Java无法解析这类路径，传入后必然扫描失败。

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