使用SQLite时npx drizzle-kit generate无法检测Schema变更求助

问题场景 #

使用Drizzle ORM搭配SQLite，初始Schema定义了仅含id字段的users表，已成功生成并执行迁移。后续在users表中新增name字段后，执行npx drizzle-kit generate时工具提示No schema changes, nothing to migrate 😴，但字段新增确实存在。该问题仅在SQLite环境出现，PostgreSQL下正常工作。

初始Schema：

import { sql } from "drizzle-orm";
import { text, sqliteTable } from "drizzle-orm/sqlite-core";

export const users = sqliteTable('users', {
  id: text('id'),
});

修改后的Schema：

import { sql } from "drizzle-orm";
import { text, sqliteTable } from "drizzle-orm/sqlite-core";

export const users = sqliteTable('users', {
  id: text('id'),
  name: text('name')
});

问题原因 #

核心原因是SQLite作为文件型数据库，drizzle-kit需要准确读取到当前数据库文件的结构才能对比Schema变更：

• 如果配置中数据库路径错误，工具会默认连接一个空的临时SQLite数据库，对比后自然认为没有变更
• PostgreSQL基于网络连接，配置正确时能直接读取数据库的真实Schema，因此不会出现该问题

其他可能诱因：

• drizzle-kit缓存了旧的Schema快照
• Schema文件路径配置错误，工具未加载到修改后的Schema

解决方案 #

• 修正drizzle.config.ts配置
  确保dbCredentials.url指向你实际使用的SQLite数据库文件，示例配置：

  import type { Config } from "drizzle-kit";
  
  export default {
    schema: "./src/schema.ts", // 确保指向你的Schema文件路径
    driver: "sqlite",
    dbCredentials: {
      url: "./dev.db", // 替换为你的SQLite数据库文件路径
    },
    out: "./drizzle",
  } satisfies Config;
  

• 清除drizzle-kit缓存
  删除项目根目录下的.drizzle缓存目录（如果存在），重新执行npx drizzle-kit generate

• 验证Schema文件加载
  确认schema配置项指向的文件是你修改后的版本，避免因路径错误导致工具读取旧Schema

• 检查迁移元数据
  查看drizzle目录下的_journal.json文件，确认初始迁移已被正确记录，没有异常条目干扰变更检测

内容的提问来源于stack exchange，提问作者Ashiqul Islam Ayon