Java运行报错：找不到主类（wrong name）问题分析与解决

问题还原 #

• 创建JavaTutorial文件夹，将./Testing/Testing.java移入后，文件路径为./JavaTutorial/Testing/Testing.java
• 根目录执行编译命令：javac JavaTutorial/Testing/Testing.java，成功生成Testing.class
• 运行命令java JavaTutorial/Testing/Testing报错：

  Error: Could not find or load main class JavaTutorial.Testing.Testing
  Caused by: java.lang.NoClassDefFoundError: JavaTutorial/Testing/Testing (wrong name: Testing)

• 原文件包声明为package Testing;，修改为package Testing.Testing;时触发报错：

  The declared package "Testing.Testing" does not match the expected package "Testing"

• 改外层文件夹名为JavaTT后问题解决，怀疑JavaTutorial是不可用的文件夹名。

原因分析 #

1. 类全限定名不匹配：执行java JavaTutorial/Testing/Testing时，JVM会将路径解析为全限定类名JavaTutorial.Testing.Testing，但实际类的包声明是Testing，类名是Testing，全限定名应为Testing.Testing，两者不匹配导致JVM无法找到对应类。
2. 文件夹名冲突：JavaTutorial大概率与JDK内置模块、系统保留名称或环境中的类路径配置存在冲突，导致JVM类加载逻辑异常。这种情况属于特定环境下的名称碰撞，新手容易踩坑。

解决建议 #

• 规避敏感文件夹名：避免使用可能与JDK内置组件、常用工具或教程默认名称重复的文件夹名，比如JavaTutorial这类常见教程命名。
• 严格遵循包路径规范：类文件路径必须和包声明完全对应。如果包声明是package Testing;，类文件应放在./Testing/Testing.java，编译后在根目录执行java Testing.Testing即可运行（JDK默认将当前目录作为类路径）。
• 正确指定类路径：如果要将类放在外层文件夹（如JavaTT），需将该文件夹作为类路径根目录。可以进入JavaTT目录执行java Testing.Testing，或者在根目录用-cp参数指定：java -cp JavaTT Testing.Testing。

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