Eclipse中无法连接Apache Derby数据库：找不到org.apache.derby.jdbc.ClientDriver

• 核对驱动配置细节
  确认驱动定义中选择的JAR与连接模式匹配：网络服务器模式需使用derbyclient.jar，嵌入式模式用derby.jar；同时驱动类名要对应正确——网络模式为org.apache.derby.jdbc.ClientDriver，嵌入式模式为org.apache.derby.jdbc.EmbeddedDriver，避免类名与模式不匹配导致的识别失败。

• 修正连接URL格式
  若使用网络服务器模式（与你命令行连接的模式一致），URL必须遵循标准格式：

  jdbc:derby://localhost:1527/sample;create=true;user=user;password=user
  

  注意：create=true参数确保数据库不存在时自动创建；端口1527需与Derby服务器启动端口完全一致；参数间用分号分隔，切勿遗漏。

• 验证Derby服务器状态
  用命令netstat -ano | findstr 1527检查端口1527是否被Derby进程占用，排除端口冲突；先执行stopNetworkServer.bat停止服务器，再重新启动startNetworkServer.bat，确保服务器干净运行。

• Eclipse连接配置二次检查
  切换到Database Development透视图，在Data Source Explorer中右键连接选择Properties，逐一确认数据库名、用户名、密码、URL参数完全正确；同时确保驱动定义中的JAR路径与Java Build Path中添加的JAR路径一致，避免路径引用失效。

• 手动测试连接代码
  编写简单代码直接测试连接，排除Eclipse工具本身的问题：

  import java.sql.Connection;
  import java.sql.DriverManager;
  
  public class TestDerbyConn {
      public static void main(String[] args) {
          try {
              Class.forName("org.apache.derby.jdbc.ClientDriver");
              Connection conn = DriverManager.getConnection("jdbc:derby://localhost:1527/sample;user=user;password=user");
              System.out.println("连接成功！");
              conn.close();
          } catch (Exception e) {
              e.printStackTrace();
          }
      }
  }
  

  若代码执行成功，说明问题出在Eclipse连接配置；若失败，则需重新排查驱动或服务器配置。

• 环境变量确认
  检查DERBY_HOME是否指向正确的Derby安装目录，%DERBY_HOME%\lib是否已加入CLASSPATH（虽Eclipse手动添加JAR后此步骤非必须，但可排除全局环境问题）。

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