AdonisJS 5 能否不预先在config/database.ts声明配置就动态创建数据库连接

可以实现不预先在config/database.ts中声明配置，动态创建数据库连接的需求，具体实现方式如下：

核心实现逻辑 #

AdonisJS 提供了数据库管理器实例直接操作连接，不需要依赖静态配置文件：

• 从@ioc:Adonis/Lucid/Database引入的默认导出对象上挂载了manager实例，通过manager.add()方法即可动态添加新的连接配置。
• 新增的连接配置结构和静态配置文件中的单连接配置完全一致，可直接复用现有模板仅修改差异参数。
• 调用Database.connection(自定义连接名)即可获取对应连接实例，首次调用会自动建立数据库连接。

示例代码 #

import Database from '@ioc:Adonis/Lucid/Database'

/**
 * 创建动态数据库连接
 * @param connName 自定义唯一连接名
 * @param dbConfig 目标数据库连接参数
 */
async function getDynamicConnection(connName: string, dbConfig: {
  host: string,
  port: number,
  user: string,
  password: string,
  database: string
}) {
  // 避免重复创建已存在的连接
  if (Database.manager.has(connName)) {
    return Database.connection(connName)
  }

  // 添加动态连接配置
  Database.manager.add(connName, {
    client: 'mysql', // 可根据实际场景替换为pg、sqlite3等你使用的客户端
    connection: dbConfig,
    healthCheck: false,
    debug: false,
  })

  return Database.connection(connName)
}

注意事项 #

• 动态连接支持所有Lucid ORM操作，调用时指定连接名即可，例如：User.query().connection('自定义连接名').where('id', 1).first()，所有结构一致的库可复用同一套模型代码。
• 不再使用的连接建议手动清理，避免占用数据库连接资源：await Database.manager.close(connName, true)，第二个参数传true会同时移除该连接的配置。
• 连接名需要保证全局唯一，建议使用租户ID、数据库名等唯一标识作为连接名，避免冲突。

内容的提问来源于stack exchange，提问作者Felix gani harris