SQLite JDBC中metadata.getPrimaryKeys返回外键信息问题咨询

我之前也踩过SQLite JDBC驱动的这个坑——调用DatabaseMetaData.getPrimaryKeys()方法时，居然返回了外键相关的内容，完全不是预期的主键信息，和你说的JUnit断言失败场景一模一样：预期值是<[]id>，实际拿到的却是<[foreign key (bar_]id>。

问题根源 #

这是SQLite JDBC驱动（xerial/sqlite-jdbc）的一个历史bug：驱动在解析SQLite系统表sqlite_master中的CREATE TABLE语句时，用于匹配主键的正则表达式存在逻辑缺陷，会误将外键定义片段里的字段名识别成主键返回。当你的表结构里外键字段和主键字段同名，或者CREATE TABLE语句中外键定义的写法比较紧凑时，这个问题触发概率极高。

解决方案（按优先级排序） #

• 优先升级驱动版本
  这个bug在3.36.0.3及以后的版本中已经被修复了，升级到最新稳定版是最彻底的解决办法。如果是Maven项目，修改pom.xml依赖：

  <dependency>
      <groupId>org.xerial</groupId>
      <artifactId>sqlite-jdbc</artifactId>
      <version>3.41.2.1</version> <!-- 建议用最新稳定版 -->
  </dependency>
  

  我当时升级到3.39.0.0就彻底解决了这个问题，JUnit断言直接通过。

• 临时 workaround：手动过滤结果
  如果暂时没法升级驱动，可以在获取结果后手动过滤掉异常数据：

  ResultSet pkResultSet = metaData.getPrimaryKeys(null, null, "your_target_table");
  List<String> validPrimaryKeys = new ArrayList<>();
  while (pkResultSet.next()) {
      String columnName = pkResultSet.getString("COLUMN_NAME");
      // 过滤掉包含外键关键字的错误结果
      if (!columnName.contains("foreign key")) {
          validPrimaryKeys.add(columnName);
      }
  }
  // 用过滤后的集合做断言逻辑
  

• 绕开JDBC API：直接查询SQLite系统表
  如果不想依赖JDBC的元数据方法，直接查询SQLite的系统表获取主键是最可靠的方式：

  SELECT name FROM pragma_table_info('your_target_table') WHERE pk = 1;
  

  在Java代码中执行这条SQL，就能精准拿到主键字段名列表，完全不会出现混淆外键的情况。

额外验证 #

升级驱动后，建议检查你的CREATE TABLE语句，确保主键定义和外键定义有清晰的分隔（比如用换行或分号分隔），避免驱动解析时再次出现异常。

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