已引入JAR包仍报ClassNotFoundException：Derby嵌入式驱动加载失败求助

安全阿岳

2026-5-26

解决 Derby EmbeddedDriver 加载失败（ClassNotFoundException）的问题

看起来你已经做了基础的依赖引入，但还是栽在了驱动类找不到的问题上——这种情况在Web项目里太常见了，我帮你梳理几个核心排查点：

先确认JAR包放对了地方
普通Java项目把derby.jar丢到项目lib就行，但Servlet项目（比如跑在Tomcat上）不一样：Web应用的类加载器有层级，你如果只把JAR放在项目自己的WEB-INF/lib，有时候会因为类加载优先级问题找不到；更稳妥的方式是把derby.jar放到服务器的全局lib目录（比如Tomcat的CATALINA_HOME/lib），或者在IDE里把这个JAR的依赖范围设置为Runtime（而非Provided），确保部署时JAR能被Web应用正确加载。
别搞混Derby的JAR包
你要的是嵌入式驱动，对应的是derby.jar，如果不小心引入了derbyclient.jar（这是客户端驱动，用于连接远程Derby服务器），里面根本没有org.apache.derby.jdbc.EmbeddedDriver这个类！赶紧检查你引入的JAR文件名，解压看看里面的目录结构，确认org/apache/derby/jdbc/EmbeddedDriver.class存在。
校验驱动类名和URL格式
你的类名是对的，但连接URL得写完整，嵌入式Derby的标准格式是：
```
con = DriverManager.getConnection("jdbc:derby:yourDBName;create=true");
```
其中create=true是关键参数，能自动创建不存在的数据库，别漏掉。
Maven/Gradle依赖要配置对
如果用构建工具管理依赖，别把scope设成test或者provided，比如Maven的正确配置应该是：
```
<dependency>
    <groupId>org.apache.derby</groupId>
    <artifactId>derby</artifactId>
    <version>你的Derby版本号</version>
    <scope>runtime</scope>
</dependency>
```
这样打包时才会把JAR包含到WEB-INF/lib里。