Knex已配置mysql2仍尝试使用sqlite3的问题求助

问题原因 #

你直接调用knex('users').insert(...)时，没有传入任何配置参数，Knex会默认使用sqlite3作为客户端，这就是报错找不到sqlite3模块的原因——哪怕你已经在knexfile.ts里配置了mysql2，直接导入的knex函数并不会自动读取这个配置文件。

而knex-cli能正常工作是因为它会自动识别项目根目录下的knexfile.ts，加载对应的配置。

正确解决方案 #

不要直接使用导入的knex函数，而是从knexfile.ts加载配置并初始化Knex实例，这样能复用统一的配置，避免重复代码：

步骤1：创建Knex实例单文件 #

在项目中新建一个db.ts（可根据项目结构调整路径），专门负责初始化Knex实例：

import knex from 'knex';
import config from './knexfile';

// 加载当前环境的配置，默认取development
const environment = process.env.NODE_ENV || 'development';
const knexInstance = knex(config[environment]);

export default knexInstance;

步骤2：在业务代码中复用这个实例 #

修改root.ts，导入上面创建的Knex实例，替代直接导入的knex函数：

import { FastifyPluginAsync } from 'fastify';
import knex from './db'; // 导入统一的Knex实例

const root: FastifyPluginAsync = async (fastify, opts): Promise<void> => {
  
  fastify.post('/create', async(request, reply) => {
    await knex('users').insert(request.body);    
    return {message: request.body};
  });
};

export default root;

方案优势 #

• 统一配置管理：所有数据库操作复用同一套配置，后续修改只需调整knexfile.ts
• 连接池优化：全局只初始化一次Knex连接池，避免重复创建连接，提升性能
• 代码解耦：分离配置与业务逻辑，代码结构更清晰

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