创建JavaDB时报ClassNotFoundException: org.apache.derby.jdbc.ClientDriver问题咨询

针对创建JavaDB时弹出java.lang.ClassNotFoundException: org.apache.derby.jdbc.ClientDriver的问题，按以下步骤排查修复即可：

• 核对驱动jar包与场景的匹配关系
  ClientDriver类仅存在于Derby客户端依赖包derbyclient.jar中，如果你在驱动配置时误选了Derby解压目录下的derby.jar（嵌入式核心包）、derbynet.jar（网络服务启动包）等其他文件，就会直接触发类找不到的报错。
  排查操作：打开驱动配置界面，确认选中的jar包路径为<db-derby-10.15.2.0-bin解压目录>/lib/derbyclient.jar。
• 确认驱动配置的生效范围
  如果你仅将Derby驱动添加到了单个项目的构建路径中，IDE的服务/数据库面板是独立的类加载域，不会读取项目级的类路径配置，自然无法加载到对应驱动类。
  排查操作：打开IDE全局的驱动管理面板，找到你配置的JavaDB/Derby驱动条目，手动添加derbyclient.jar的绝对路径，不要依赖项目类路径的自动关联。
• 校验驱动类路径的正确性
  部分内置Derby驱动模板的IDE，默认填写的是嵌入式驱动类org.apache.derby.jdbc.EmbeddedDriver，如果手动修改为客户端驱动类时出现拼写错误、大小写偏差、包层级缺失，也会触发类找不到的报错。
  排查操作：用压缩工具打开derbyclient.jar，依次展开路径org/apache/derby/jdbc/，确认ClientDriver.class真实存在，和创建数据库表单里填写的驱动类全路径完全一致。
• 清理类加载缓存
  如果以上配置全部正确仍报错，直接删除当前已配置的Derby驱动条目，重新新建驱动配置，重新关联jar包、填写正确的驱动类，重启IDE后再执行数据库创建操作，即可解决IDE旧缓存导致的类加载失败问题。

注意：如果你是在本地创建嵌入式JavaDB，不需要启动Derby网络服务，可直接将驱动类替换为org.apache.derby.jdbc.EmbeddedDriver，关联derby.jar作为驱动依赖，无需额外配置客户端包。

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