JavaFX独立应用使用嵌入式Derby+JDBC时表不存在异常求助

我之前在使用嵌入式Derby开发Java应用时也踩过类似的坑，咱们一步步来排查这个java.sql.SQLSyntaxErrorException: Table/View 'BUILDINGS' does not exist的问题：

1. 先核对JDBC连接URL的正确性 #

嵌入式Derby的URL格式是关键，比如正确的格式应该是：

String url = "jdbc:derby:your_database_name;create=true";

这里要注意两个点：

• create=true参数：如果指定的数据库不存在，Derby会自动创建它。但如果没加这个参数，或者数据库名拼写错误，就会连接到一个不存在的数据库（或者空数据库），自然找不到BUILDINGS表。
• 数据库的存储路径：嵌入式模式下，数据库默认会在当前应用的工作目录下创建。你可以在代码里打印当前工作目录，确认数据库文件的位置：

System.out.println("当前工作目录：" + System.getProperty("user.dir"));

去这个目录下看看有没有以你的数据库名命名的文件夹，比如数据库名是appdb，就找appdb文件夹，里面应该有Derby的存储文件，如果连这个文件夹都没有，说明连接URL的数据库名错了，或者create=true没生效。

2. 确认建表语句确实执行成功 #

很多时候表不存在，是因为建表语句根本没执行，或者执行失败了但没被捕获。你可以在执行建表的地方加日志或打印，同时捕获异常：

try (Connection conn = DriverManager.getConnection(url, user, password)) {
    String createTableSQL = "CREATE TABLE BUILDINGS (" +
                            "id INT PRIMARY KEY, " +
                            "name VARCHAR(100))";
    try (Statement stmt = conn.createStatement()) {
        stmt.executeUpdate(createTableSQL);
        System.out.println("BUILDINGS表创建成功！");
    }
} catch (SQLException e) {
    // 这里要打印完整的异常信息，看看建表时有没有报错
    e.printStackTrace();
}

如果建表时抛出了异常（比如语法错误、权限问题），就会导致表没创建出来，但你的后续操作还在查这个表，自然会报错。

3. 检查表名的大小写问题 #

Derby默认是大小写不敏感的，但有个例外：如果创建表时用了双引号包裹表名，比如：

CREATE TABLE "BUILDINGS" (id INT PRIMARY KEY)

那后续查询时必须也用双引号包裹表名，否则Derby会把表名转换成小写，导致找不到BUILDINGS（实际存储的是大写的表名）。反过来，如果创建表时没加引号，查询时用了引号，也会出问题。

所以确保你的建表语句和查询语句的表名大小写一致，且引号使用统一。

4. 确认连接的是同一个数据库实例 #

有时候会出现代码里多次创建不同数据库的情况，比如某次测试时用了jdbc:derby:testdb;create=true，后来改成了jdbc:derby:prod;create=true，但之前的表是在testdb里创建的，现在连接prod自然找不到表。

仔细检查代码中所有使用JDBC连接的地方，确保URL里的数据库名完全一致。

5. 手动验证数据库中的表 #

如果以上步骤都没问题，你可以用Derby的命令行工具ij来连接数据库，手动查看表是否存在：

1. 找到Derby的安装目录，进入bin文件夹；
2. 运行ij.bat（Windows）或ij.sh（Linux/Mac）；
3. 在ij中执行连接命令：

CONNECT 'jdbc:derby:/path/to/your/database';

这里的路径就是你之前打印的工作目录加上数据库名；
4. 然后执行查询表的命令：

SELECT * FROM BUILDINGS;

或者查看所有表：

SELECT TABLE_NAME FROM SYS.SYSTABLES WHERE TABLE_TYPE='T';

如果这里也找不到表，说明表确实没创建出来，回到建表逻辑排查；如果能找到，那问题出在你的Java代码的连接或查询逻辑上。

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