解决Java Derby数据库“未找到”错误：原理与实践-java教程-PHP中文网

解决Java Derby数据库“未找到”错误：原理与实践

心靈之曲

发布： 2025-09-26 13:00:06

原创

606人浏览过

解决Java Derby数据库“未找到”错误：原理与实践

本文旨在解决Java Derby数据库在使用create=true参数后仍报告“数据库未找到”的常见问题。核心原因在于Java应用程序与Derby的ij工具在查找或创建数据库时，默认的工作目录不一致。文章将详细阐述这一机制，并提供两种有效的解决方案：确保ij工具在正确的目录执行，或直接通过ij命令创建数据库，以实现数据库的成功连接与管理。

理解Derby数据库的创建与查找机制

当我们在java应用程序中使用drivermanager.getconnection("jdbc:derby:javadb;create=true")这样的代码时，derby数据库（例如名为javadb）会在java程序执行的当前工作目录下被创建。这意味着，如果你的java项目在c:\users\youruser\documents\javaproject目录下运行，那么javadb数据库文件夹就会出现在这个路径下。

然而，当尝试通过Derby的命令行工具ij连接到这个数据库时，例如在derbyrun.jar所在的lib文件夹中执行java -jar derbyrun.jar ij，然后输入connect 'jdbc:derby:javaDb';，ij工具默认会在其自身的执行目录（通常是Derby安装目录下的lib文件夹）中查找javaDb数据库。由于这两个位置通常不同，ij自然会报告“数据库未找到”的错误（ERROR XJ004: Database 'javaDb' not found.）。

为了解决这种工作目录不匹配导致的问题，我们可以采用以下两种主要策略。

解决方案一：确保ij在正确的目录下执行

最直接的方法是确保ij工具在与Java应用程序创建数据库时相同的目录下运行。这意味着你需要从Java项目根目录（即数据库创建的位置）来启动ij。

步骤：

立即学习“Java免费学习笔记（深入）”；

确认数据库创建位置： 你的Java代码如下：

public class Main{
    public static void main(String[] args) {        
        try {
            // 这行代码会在程序运行的当前工作目录创建或连接javaDb
            DriverManager.getConnection("jdbc:derby:javaDb;create=true");
        } catch (SQLException e){
            e.printStackTrace();
        }
    } 
}

登录后复制

执行上述Java代码后，请检查你的Java项目根目录，会发现一个名为javaDb的文件夹，其中包含Derby数据库文件。

从Java项目根目录启动ij： 打开命令行窗口，导航到你的Java项目根目录。然后，使用Derby安装路径下的derbyrun.jar来启动ij。

假设你的Derby安装在C:\derbydb\db-derby-10.16.1.1-bin，而你的Java项目在C:\Users\me\Documents\JavaDerbyDemo。

首先，在C:\Users\me\Documents\JavaDerbyDemo目录下执行你的Java程序，以确保javaDb数据库在此处被创建。

然后，在同一个C:\Users\me\Documents\JavaDerbyDemo目录下，执行以下命令来启动ij：

挖错网
一款支持文本、图片、视频纠错和AIGC检测的内容审核校对平台。

28

查看详情
```
# 如果设置了DERBY_HOME环境变量
java -jar %DERBY_HOME%\lib\derbyrun.jar ij

# 或者直接使用完整的Derby lib路径
java -jar C:\derbydb\db-derby-10.16.1.1-bin\lib\derbyrun.jar ij
```
登录后复制
（请将路径替换为你的实际Derby安装路径）
在ij中连接数据库： 当ij>提示符出现后，直接使用数据库名称连接：
```
ij> connect 'jdbc:derby:javaDb';
```
登录后复制
此时，ij会在其当前工作目录（即你的Java项目根目录）找到javaDb数据库并成功连接。

注意事项：

不建议将Java应用程序创建的数据库文件夹手动复制到Derby安装的lib文件夹中，这可能会使lib文件夹变得混乱。
确保java命令在系统的PATH环境变量中，或者使用Java的完整安装路径。

解决方案二：直接使用ij工具创建数据库

另一种更简洁的方法是，如果你主要通过ij工具来管理或初始化数据库，可以直接在ij中创建数据库。

步骤：

立即学习“Java免费学习笔记（深入）”；

从任意位置启动ij： 你可以从Derby安装目录的lib文件夹启动ij，或者从你希望数据库被创建的任何其他目录启动。
```
# 在Derby安装目录的lib文件夹中
java -jar derbyrun.jar ij
```
登录后复制
在ij中创建并连接数据库： 在ij>提示符下，使用create=true参数来创建数据库。
```
ij> connect 'jdbc:derby:javaDbTwo;create=true';
```
登录后复制
执行此命令后，一个名为javaDbTwo的数据库文件夹将在你启动ij工具的当前工作目录下被创建。后续你可以直接使用connect 'jdbc:derby:javaDbTwo';来连接它。这种方法可以确保ij在创建和连接数据库时始终使用一致的上下文。