在使用Apache Derby作为嵌入式数据库时，开发者常会遇到一个困扰：Java应用程序成功通过create=true参数创建了数据库，但随后使用Derby自带的ij命令行工具尝试连接时，却提示“数据库未找到”（ERROR XJ004）。这并非Derby的错误，而是对数据库文件存储路径和ij工具工作原理理解不足所致。
根本原因在于，当Java应用程序通过DriverManager.getConnection("jdbc:derby:javaDb;create=true");这样的代码创建数据库时，该数据库（表现为一个名为javaDb的文件夹）默认会生成在Java程序执行时的“当前工作目录”下，这通常是你的Java项目根目录。然而，当你从Derby安装目录的lib文件夹下运行java -jar derbyrun.jar ij命令，并在ij>提示符下尝试connect 'jdbc:derby:javaDb';时，ij工具会默认在它被启动的目录（即lib目录）下寻找javaDb。由于这两个位置通常是不同的，便会导致连接失败。
解决方案一：从数据库创建目录启动 ij 工具
最直接的解决方法是确保ij工具在与数据库相同的目录下运行。这意味着你需要将derbyrun.jar的启动命令指向你Java项目创建数据库的根目录。
步骤：
立即学习“Java免费学习笔记（深入）”；
- 确定数据库创建路径： 运行你的Java应用程序，它会在项目根目录下创建一个名为javaDb（或你指定的数据库名）的文件夹。
- 从该目录启动 ij： 打开命令行窗口，导航到你的Java项目根目录（即javaDb文件夹的父目录），然后执行以下命令启动ij工具。
示例代码 (Java):
import java.sql.DriverManager;
import java.sql.SQLException;
public class DerbyDbCreator {
public static void main(String[] args) {
try {
// 这将在当前工作目录创建名为 'javaDb' 的数据库
DriverManager.getConnection("jdbc:derby:javaDb;create=true");
System.out.println("数据库 'javaDb' 已创建或已连接。");
} catch (SQLException e){
System.err.println("数据库操作失败: " + e.getMessage());
e.printStackTrace();
}
}
}示例命令 (CMD/Bash):
假设你的Java项目根目录是 C:\Users\YourUser\JavaDerbyProject，并且Derby安装在 C:\derbydb\db-derby-10.16.1.1-bin。
首先，编译并运行Java代码以创建数据库：
# 在 C:\Users\YourUser\JavaDerbyProject 目录下运行 cd C:\Users\YourUser\JavaDerbyProject javac DerbyDbCreator.java java DerbyDbCreator # 此时，C:\Users\YourUser\JavaDerbyProject 下会生成一个 'javaDb' 文件夹
然后，从Java项目根目录启动ij并连接：
# 确保当前目录是 C:\Users\YourUser\JavaDerbyProject cd C:\Users\YourUser\JavaDerbyProject # 使用完整的derbyrun.jar路径启动ij java -jar C:\derbydb\db-derby-10.16.1.1-bin\lib\derbyrun.jar ij
在ij>提示符下，现在你可以成功连接到数据库：
ij> connect 'jdbc:derby:javaDb';
如果你的系统设置了DERBY_HOME环境变量，你可以使用它来简化命令：
java -jar %DERBY_HOME%\lib\derbyrun.jar ij
（在Linux/macOS上，使用java -jar $DERBY_HOME/lib/derbyrun.jar ij）
解决方案二：使用 ij 工具直接创建并连接数据库
另一种更简洁的方法是直接在ij工具中创建数据库。这种方式确保了数据库在ij工具的当前工作目录下创建，从而避免了路径不一致的问题。
步骤：
立即学习“Java免费学习笔记（深入）”；
-
启动 ij 工具： 从你希望数据库被创建的任何目录启动ij工具。例如，你可以在Derby安装目录的lib文件夹下启动，或者在你的项目工作目录。
# 例如，在 C:\Users\YourUser\JavaDerbyProject 目录下启动 cd C:\Users\YourUser\JavaDerbyProject java -jar C:\derbydb\db-derby-10.16.1.1-bin\lib\derbyrun.jar ij
- 在 ij 中创建并连接数据库： 在ij>提示符下，使用create=true参数进行连接。
示例命令 (ij):
ij> connect 'jdbc:derby:javaDbTwo;create=true';
执行此命令后，一个名为javaDbTwo的数据库文件夹将在你启动ij工具的当前目录下被创建。此后，你可以不带create=true参数再次连接到它。
注意事项与最佳实践
- 避免移动数据库文件： 不建议将Java应用程序创建的数据库文件夹复制到Derby安装的lib目录。这会使lib目录变得混乱，且不是管理数据库的规范方式。
- 明确数据库路径： 在生产环境中，为了更好的可移植性和管理，通常会通过JDBC连接字符串明确指定数据库的绝对路径，而不是依赖于当前工作目录。例如：jdbc:derby:/path/to/your/database/javaDb;create=true。
- 环境变量 DERBY_HOME： 设置DERBY_HOME环境变量可以简化derbyrun.jar的调用，提高命令的可读性和便捷性。
- 嵌入式与客户端/服务器模式： 本文讨论的是Derby的嵌入式模式。在客户端/服务器模式下，数据库通常运行在一个单独的Derby网络服务器进程中，客户端通过网络连接，路径管理方式会有所不同。
总结
解决Java Derby数据库“未找到”的问题，关键在于理解数据库的物理存储位置与ij工具的查找逻辑之间的关系。通过确保ij工具在数据库创建的同一目录下运行，或直接利用ij工具创建数据库，可以有效地避免路径冲突，实现数据库的顺利连接和管理。遵循这些实践，将有助于开发者更高效地使用Apache Derby数据库。
