无法在IntelliJ IDEA中连接MySQL Connector（JDBC类路径问题）

排查与修复步骤 #

• 确认JAR文件有效性：不要自行用WinRAR将ZIP转成JAR，直接下载MySQL官方提供的mysql-connector-java-x.x.xx.jar成品包。自行打包的JAR大概率缺失必要的目录结构或MANIFEST配置，导致无法被Java识别。
• 临时类路径测试：在命令行运行程序时，直接通过-cp参数指定JAR路径，快速验证是否是环境变量配置问题：

  # Windows系统用分号分隔路径
  java -cp .;C:\your-path\mysql-connector-java-x.x.xx.jar YourMainClassName
  # Linux/macOS系统用冒号分隔路径
  java -cp .:/your-path/mysql-connector-java-x.x.xx.jar YourMainClassName
  

  若此方式能正常运行，说明系统环境变量的CLASSPATH配置存在问题。
• 检查系统CLASSPATH环境变量：
  • 控制面板中设置的CLASSPATH，必须直接指向正确的JAR文件路径，而非ZIP包或文件夹。
  • 确保CLASSPATH中包含.（代表当前目录），否则Java无法找到你编写的主类文件。
• IDE环境额外验证：如果使用IDE（如Eclipse、IDEA）开发，需将JAR包添加到项目的库依赖中，仅修改系统环境变量不会生效。
• 校验JAR内部结构：用压缩工具打开官方JAR包，确认存在com/mysql/cj/jdbc/Driver.class（新版本驱动）或com/mysql/jdbc/Driver.class（旧版本驱动），若缺失则说明JAR文件损坏，重新下载即可。

避坑提示 #

• 禁止直接修改ZIP文件后缀名为JAR，这种操作不会生成符合Java规范的类库文件。
• 系统级CLASSPATH可能被其他程序覆盖，优先使用命令行-cp参数做快速验证。

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