@dangao/bun-server 3.1.0 → 3.3.0

package/docs/database.md

@@ -25,6 +25,50 @@ DatabaseModule.forRoot({
 });
 ```
 
+## Driver selection (decoupled from the runtime platform)
+
+> Added in v3.2.0.
+
+By default the underlying driver for Postgres/MySQL is chosen by the runtime platform: the Bun runtime uses the built-in `Bun.SQL`, while Node.js uses the pure-JS `mysql2` / `postgres` drivers.
+
+The optional `driver` field lets you **explicitly pick a pure-JS driver even under the Bun runtime**, decoupled from the platform engine (fs/crypto/http server, etc.):
+
+| driver | Behavior |
+| --- | --- |
+| `'auto'` (default) | Bun → `Bun.SQL`; Node → `mysql2` (MySQL) / `postgres` (PostgreSQL). Backward compatible. |
+| `'mysql2'` | Always use `mysql2`, regardless of runtime (only for `type: 'mysql'`). |
+| `'postgres'` | Always use `postgres`, regardless of runtime (only for `type: 'postgres'`). |
+| `'bun-sql'` | Force `Bun.SQL` (valid on Bun only; throws a clear error on Node). |
+
+```ts
+DatabaseModule.forRoot({
+  database: {
+    type: 'mysql',
+    driver: 'mysql2', // uses mysql2 even on the Bun runtime
+    config: {
+      host: '127.0.0.1',
+      port: 3306,
+      database: 'app',
+      user: 'root',
+      password: process.env.DB_PASSWORD!,
+    },
+  },
+});
+
+// The V2 single-tenant form is supported too:
+DatabaseModule.forRoot({
+  type: 'mysql',
+  url: process.env.DB_URL!,
+  driver: 'mysql2',
+});
+```
+
+### Why? MySQL under `bun build --compile`
+
+A single binary produced by `bun build --compile` freezes the Bun runtime at build time, and the built-in `Bun.SQL` MySQL adapter has several known issues. Setting `driver: 'mysql2'` lets the compiled binary connect using the statically bundled pure-JS `mysql2` driver, without falling back to SQLite and without switching the whole platform via `BUN_SERVER_PLATFORM=node` (which would also move the HTTP server to Node).
+
+The `driver` switch is orthogonal to `BUN_SERVER_PLATFORM`: the former only selects the SQL driver, while the latter selects the entire platform engine.
+
 ## Route strategy
 
 ```ts

package/docs/zh/database.md

@@ -25,6 +25,50 @@ DatabaseModule.forRoot({
 });
 ```
 
+## 驱动选择（driver，与运行时平台解耦）
+
+> v3.2.0 新增。
+
+默认情况下，Postgres/MySQL 连接的底层驱动由运行时平台决定：Bun 运行时使用内建 `Bun.SQL`，Node.js 运行时使用 `mysql2` / `postgres` 纯 JS 驱动。
+
+通过可选的 `driver` 字段，可以**在 Bun 运行时下也显式选用纯 JS 驱动**，与平台引擎（fs/crypto/http server 等）解耦：
+
+| driver | 行为 |
+| --- | --- |
+| `'auto'`（默认） | Bun → `Bun.SQL`；Node → `mysql2`（MySQL）/ `postgres`（PostgreSQL）。向后兼容。 |
+| `'mysql2'` | 无论运行时如何，都使用 `mysql2`（仅 `type: 'mysql'`）。 |
+| `'postgres'` | 无论运行时如何，都使用 `postgres`（仅 `type: 'postgres'`）。 |
+| `'bun-sql'` | 强制使用 `Bun.SQL`（仅 Bun 合法，Node 会抛出清晰错误）。 |
+
+```ts
+DatabaseModule.forRoot({
+  database: {
+    type: 'mysql',
+    driver: 'mysql2', // 即使在 Bun 运行时也走 mysql2
+    config: {
+      host: '127.0.0.1',
+      port: 3306,
+      database: 'app',
+      user: 'root',
+      password: process.env.DB_PASSWORD!,
+    },
+  },
+});
+
+// V2 单租户写法同样支持：
+DatabaseModule.forRoot({
+  type: 'mysql',
+  url: process.env.DB_URL!,
+  driver: 'mysql2',
+});
+```
+
+### 为什么需要它？`bun build --compile` 下的 MySQL
+
+`bun build --compile` 产出的单二进制会把当时的 Bun 运行时焊死，其中内建 `Bun.SQL` 的 MySQL 适配带有若干已知问题。显式设置 `driver: 'mysql2'` 即可让编译产物使用静态打包的纯 JS `mysql2` 驱动连库，无需为此回退到 SQLite，也无需用 `BUN_SERVER_PLATFORM=node` 整体切平台（那会把 HTTP server 也切到 Node）。
+
+`driver` 开关与 `BUN_SERVER_PLATFORM` 正交：前者只决定 SQL 驱动，后者决定整个平台引擎。
+
 ## 路由策略示例
 
 ```ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dangao/bun-server",
-  "version": "3.1.0",
+  "version": "3.3.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -48,7 +48,7 @@
     "test:bun": "bun test tests/platform/bun",
     "test:node": "vitest run tests/platform/node",
     "test:platform": "bun run test:bun && bun run test:node",
-    "type-check": "tsc --noEmit",
+    "typecheck": "tsc -p tsconfig.build.json --noEmit && tsc -p tsconfig.test.json --noEmit",
     "clean": "rm -rf dist",
     "bundle": "bun build src/index.ts --target=bun --format=esm --outfile=dist/index.js --external reflect-metadata --external @dangao/logsmith --external @dangao/nacos-client --external @vscode/sqlite3",
     "bundle:node": "bun build src/index.ts --target=node --packages=external --outfile=dist/index.node.mjs",
@@ -88,4 +88,4 @@
     "postgres": "^3.4.9",
     "reflect-metadata": "^0.2.2"
   }
-}
+}

package/src/ai/types.ts

@@ -144,6 +144,11 @@ export const AI_SERVICE_TOKEN = Symbol('@dangao/bun-server:ai:service');
 export const AI_MODULE_OPTIONS_TOKEN = Symbol('@dangao/bun-server:ai:options');
 export const AI_TOOL_REGISTRY_TOKEN = Symbol('@dangao/bun-server:ai:tool-registry');
 
+/**
+ * Metadata key for AiModule options.
+ */
+export const MODULE_METADATA_KEY = '@dangao/bun-server:ai:module';
+
 /**
  * Metadata key for @AiTool decorator
  */

package/src/auth/types.ts

@@ -93,6 +93,10 @@ export interface OAuth2Client {
    * 允许的授权类型
    */
   grantTypes: ('authorization_code' | 'refresh_token')[];
+  /**
+   * 允许的 OAuth2 scope 列表
+   */
+  scopes?: string[];
 }
 
 /**
@@ -245,4 +249,3 @@ export interface AuthContext {
    */
   isAuthenticated: boolean;
 }
-

package/src/cache/interceptors.ts

@@ -91,8 +91,8 @@ export class CacheableInterceptor extends BaseInterceptor {
   public async execute<T>(
     target: unknown,
     propertyKey: string | symbol,
-    originalMethod: (...args: unknown[]) => T | Promise<T>,
-    args: unknown[],
+    originalMethod: (...args: any[]) => T | Promise<T>,
+    args: any[],
     container: Container,
     context?: Context,
   ): Promise<T> {
@@ -164,8 +164,8 @@ export class CacheEvictInterceptor extends BaseInterceptor {
   public async execute<T>(
     target: unknown,
     propertyKey: string | symbol,
-    originalMethod: (...args: unknown[]) => T | Promise<T>,
-    args: unknown[],
+    originalMethod: (...args: any[]) => T | Promise<T>,
+    args: any[],
     container: Container,
     context?: Context,
   ): Promise<T> {
@@ -238,8 +238,8 @@ export class CachePutInterceptor extends BaseInterceptor {
   public async execute<T>(
     target: unknown,
     propertyKey: string | symbol,
-    originalMethod: (...args: unknown[]) => T | Promise<T>,
-    args: unknown[],
+    originalMethod: (...args: any[]) => T | Promise<T>,
+    args: any[],
     container: Container,
     context?: Context,
   ): Promise<T> {

package/src/cache/service-proxy.ts

@@ -87,9 +87,9 @@ export class CacheServiceProxy {
 
         // 返回包装后的方法
         // 使用原型方法以确保拦截器能获取到正确的元数据
-        const originalMethod = prototypeMethod as (...args: unknown[]) => unknown;
+        const originalMethod = prototypeMethod as (...args: any[]) => unknown;
 
-        return async function (this: T, ...args: unknown[]): Promise<unknown> {
+        return async function (this: T, ...args: any[]): Promise<unknown> {
           // 按优先级执行拦截器：CacheEvict (beforeInvocation) -> Cacheable/CachePut -> CacheEvict (afterInvocation)
 
           // 如果有 @CacheEvict 且配置了 beforeInvocation

package/src/cache/service.ts

@@ -13,11 +13,14 @@ export class CacheService {
   private keyPrefix: string;
 
   public constructor(
-    @Inject(CACHE_OPTIONS_TOKEN) options: CacheModuleOptions,
+    @Inject(CACHE_OPTIONS_TOKEN) options: CacheModuleOptions | CacheStore,
   ) {
-    this.store = options.store!;
-    this.defaultTtl = options.defaultTtl ?? 3600000; // 1 小时
-    this.keyPrefix = options.keyPrefix ?? '';
+    const resolvedOptions: CacheModuleOptions = isCacheStore(options)
+      ? { store: options }
+      : options;
+    this.store = resolvedOptions.store!;
+    this.defaultTtl = resolvedOptions.defaultTtl ?? 3600000; // 1 小时
+    this.keyPrefix = resolvedOptions.keyPrefix ?? '';
   }
 
   /**
@@ -25,7 +28,7 @@ export class CacheService {
    * @param key - 缓存键
    * @returns 缓存值，如果不存在则返回 undefined
    */
-  public async get<T = unknown>(key: string): Promise<T | undefined> {
+  public async get<T = any>(key: string): Promise<T | undefined> {
     return this.store.get<T>(this.getKey(key));
   }
 
@@ -36,7 +39,7 @@ export class CacheService {
    * @param ttl - 过期时间（毫秒），0 表示永不过期，undefined 使用默认 TTL
    * @returns 是否设置成功
    */
-  public async set<T = unknown>(
+  public async set<T = any>(
     key: string,
     value: T,
     ttl?: number,
@@ -76,7 +79,7 @@ export class CacheService {
    * @param keys - 缓存键数组
    * @returns 缓存值映射
    */
-  public async getMany<T = unknown>(
+  public async getMany<T = any>(
     keys: string[],
   ): Promise<Map<string, T>> {
     const prefixedKeys = keys.map((k) => this.getKey(k));
@@ -97,7 +100,7 @@ export class CacheService {
    * @param ttl - 过期时间（毫秒），0 表示永不过期，undefined 使用默认 TTL
    * @returns 是否设置成功
    */
-  public async setMany<T = unknown>(
+  public async setMany<T = any>(
     entries: Array<{ key: string; value: T }>,
     ttl?: number,
   ): Promise<boolean> {
@@ -149,3 +152,9 @@ export class CacheService {
     return this.keyPrefix ? `${this.keyPrefix}${key}` : key;
   }
 }
+
+function isCacheStore(value: CacheModuleOptions | CacheStore): value is CacheStore {
+  return typeof (value as CacheStore).get === 'function' &&
+    typeof (value as CacheStore).set === 'function' &&
+    typeof (value as CacheStore).delete === 'function';
+}

package/src/cache/types.ts

@@ -7,7 +7,7 @@ export interface CacheStore {
    * @param key - 缓存键
    * @returns 缓存值，如果不存在则返回 undefined
    */
-  get<T = unknown>(key: string): Promise<T | undefined>;
+  get<T = any>(key: string): Promise<T | undefined>;
 
   /**
    * 设置缓存值
@@ -16,7 +16,7 @@ export interface CacheStore {
    * @param ttl - 过期时间（毫秒），0 表示永不过期
    * @returns 是否设置成功
    */
-  set<T = unknown>(key: string, value: T, ttl?: number): Promise<boolean>;
+  set<T = any>(key: string, value: T, ttl?: number): Promise<boolean>;
 
   /**
    * 删除缓存
@@ -43,7 +43,7 @@ export interface CacheStore {
    * @param keys - 缓存键数组
    * @returns 缓存值映射
    */
-  getMany<T = unknown>(keys: string[]): Promise<Map<string, T>>;
+  getMany<T = any>(keys: string[]): Promise<Map<string, T>>;
 
   /**
    * 设置多个缓存值
@@ -51,7 +51,7 @@ export interface CacheStore {
    * @param ttl - 过期时间（毫秒），0 表示永不过期
    * @returns 是否设置成功
    */
-  setMany<T = unknown>(
+  setMany<T = any>(
     entries: Array<{ key: string; value: T }>,
     ttl?: number,
   ): Promise<boolean>;
@@ -84,7 +84,7 @@ export class MemoryCacheStore implements CacheStore {
     }
   }
 
-  public async get<T = unknown>(key: string): Promise<T | undefined> {
+  public async get<T = any>(key: string): Promise<T | undefined> {
     const entry = this.store.get(key);
     if (!entry) {
       return undefined;
@@ -99,7 +99,7 @@ export class MemoryCacheStore implements CacheStore {
     return entry.value as T;
   }
 
-  public async set<T = unknown>(
+  public async set<T = any>(
     key: string,
     value: T,
     ttl?: number,
@@ -133,7 +133,7 @@ export class MemoryCacheStore implements CacheStore {
     return true;
   }
 
-  public async getMany<T = unknown>(
+  public async getMany<T = any>(
     keys: string[],
   ): Promise<Map<string, T>> {
     const result = new Map<string, T>();
@@ -154,7 +154,7 @@ export class MemoryCacheStore implements CacheStore {
     return result;
   }
 
-  public async setMany<T = unknown>(
+  public async setMany<T = any>(
     entries: Array<{ key: string; value: T }>,
     ttl?: number,
   ): Promise<boolean> {
@@ -239,7 +239,7 @@ export class RedisCacheStore implements CacheStore {
     return `${this.keyPrefix}${key}`;
   }
 
-  public async get<T = unknown>(key: string): Promise<T | undefined> {
+  public async get<T = any>(key: string): Promise<T | undefined> {
     const value = await this.client.get(this.getKey(key));
     if (value === null) {
       return undefined;
@@ -251,7 +251,7 @@ export class RedisCacheStore implements CacheStore {
     }
   }
 
-  public async set<T = unknown>(
+  public async set<T = any>(
     key: string,
     value: T,
     ttl?: number,
@@ -296,7 +296,7 @@ export class RedisCacheStore implements CacheStore {
     }
   }
 
-  public async getMany<T = unknown>(
+  public async getMany<T = any>(
     keys: string[],
   ): Promise<Map<string, T>> {
     const result = new Map<string, T>();
@@ -325,7 +325,7 @@ export class RedisCacheStore implements CacheStore {
     return result;
   }
 
-  public async setMany<T = unknown>(
+  public async setMany<T = any>(
     entries: Array<{ key: string; value: T }>,
     ttl?: number,
   ): Promise<boolean> {

package/src/config/service.ts

@@ -67,12 +67,12 @@ export class ConfigService<TConfig extends Record<string, unknown> = Record<stri
    * 更新配置（用于配置中心动态刷新）
    * @param newConfig - 新配置对象
    */
-  public updateConfig(newConfig: TConfig): void {
-    this.config = newConfig;
+  public updateConfig(newConfig: TConfig | Record<string, unknown>): void {
+    this.config = newConfig as TConfig;
     // 通知所有监听器
     for (const listener of this.configUpdateListeners) {
       try {
-        listener(newConfig);
+        listener(this.config);
       } catch (error) {
         console.error('[ConfigService] Error in config update listener:', error);
       }
@@ -83,7 +83,7 @@ export class ConfigService<TConfig extends Record<string, unknown> = Record<stri
    * 合并配置（用于配置中心增量更新）
    * @param partialConfig - 部分配置对象
    */
-  public mergeConfig(partialConfig: Partial<TConfig>): void {
+  public mergeConfig(partialConfig: Partial<TConfig> | Record<string, unknown>): void {
     this.config = {
       ...this.config,
       ...partialConfig,
@@ -125,6 +125,8 @@ export class ConfigService<TConfig extends Record<string, unknown> = Record<stri
    * @param key - 配置键（如 "db.host"）
    * @param defaultValue - 默认值（可选）
    */
+  public get(key: string): any;
+  public get<T>(key: string, defaultValue?: T): T | undefined;
   public get<T = unknown>(key: string, defaultValue?: T): T | undefined {
     const namespacedKey = this.applyNamespace(key);
     const value = this.getValueByPath(this.config, namespacedKey);
@@ -138,6 +140,8 @@ export class ConfigService<TConfig extends Record<string, unknown> = Record<stri
    * 获取必需的配置值，如果不存在则抛出错误
    * @param key - 配置键
    */
+  public getRequired(key: string): any;
+  public getRequired<T>(key: string): T;
   public getRequired<T = unknown>(key: string): T {
     const value = this.get<T>(key);
     if (value === undefined) {
@@ -191,5 +195,3 @@ export class ConfigService<TConfig extends Record<string, unknown> = Record<stri
     return current;
   }
 }
-
-

package/src/core/application.ts

@@ -490,6 +490,13 @@ export class Application {
     return this.server;
   }
 
+  /**
+   * 获取底层平台服务器实例
+   */
+  public getNativeServer(): unknown {
+    return this.server?.getNativeServer();
+  }
+
   /**
    * 自动注册服务到注册中心
    * 扫描所有使用 @ServiceRegistry 装饰器的控制器，自动注册服务
@@ -639,4 +646,3 @@ export class Application {
     this.signalHandlersInstalled = false;
   }
 }
-

package/src/core/context.ts

@@ -1,5 +1,6 @@
 import { BodyParser } from '../request/body-parser';
 import type { UploadedFileInfo } from '../files';
+import type { Container } from '../di/container';
 import type { BodyInit } from 'bun'
 import { type URLSearchParams, URL } from 'url';
 
@@ -32,7 +33,7 @@ export class Context {
   /**
    * 请求路径
    */
-  public readonly path: string;
+  public path: string;
 
   /**
    * 查询参数
@@ -80,8 +81,11 @@ export class Context {
    */
   public readonly signal: AbortSignal;
 
-  public constructor(request: Request) {
+  public readonly container?: Container;
+
+  public constructor(request: Request, container?: Container) {
     this.request = request;
+    this.container = container;
     this.url = new URL(request.url);
     this.method = request.method;
     this.path = this.url.pathname;
@@ -304,4 +308,3 @@ export class Context {
     return sanitized;
   }
 }
-

package/src/database/connection-manager.ts

@@ -7,6 +7,7 @@ import type {
 } from './types';
 
 import { ConnectionPool } from './connection-pool';
+import { healthCheckViaDriver } from './driver';
 
 /**
  * 数据库连接管理器
@@ -189,58 +190,16 @@ export class DatabaseConnectionManager {
   }
 
   /**
-   * PostgreSQL 健康检查（使用 Bun.SQL）
+   * PostgreSQL 健康检查（按连接 driver tag 分流）
    */
   private async healthCheckPostgres(connection: unknown): Promise<boolean> {
-    try {
-      // Bun.SQL 对象可以作为函数调用（模板字符串）
-      if (connection && typeof connection === 'function') {
-        const result = await (connection as (template: TemplateStringsArray, ...values: unknown[]) => Promise<unknown[]>)`SELECT 1`;
-        return Array.isArray(result) && result.length > 0;
-      }
-      // 或者使用 query 方法（如果存在）
-      if (
-        connection &&
-        typeof connection === 'object' &&
-        'query' in connection &&
-        typeof connection.query === 'function'
-      ) {
-        await (connection as { query: (sql: string) => Promise<unknown> }).query(
-          'SELECT 1',
-        );
-        return true;
-      }
-      return false;
-    } catch (_error) {
-      return false;
-    }
+    return await healthCheckViaDriver(connection);
   }
 
   /**
-   * MySQL 健康检查（使用 Bun.SQL）
+   * MySQL 健康检查（按连接 driver tag 分流）
    */
   private async healthCheckMysql(connection: unknown): Promise<boolean> {
-    try {
-      // Bun.SQL 对象可以作为函数调用（模板字符串）
-      if (connection && typeof connection === 'function') {
-        const result = await (connection as (template: TemplateStringsArray, ...values: unknown[]) => Promise<unknown[]>)`SELECT 1`;
-        return Array.isArray(result) && result.length > 0;
-      }
-      // 或者使用 query 方法（如果存在）
-      if (
-        connection &&
-        typeof connection === 'object' &&
-        'query' in connection &&
-        typeof connection.query === 'function'
-      ) {
-        await (connection as { query: (sql: string) => Promise<unknown> }).query(
-          'SELECT 1',
-        );
-        return true;
-      }
-      return false;
-    } catch (_error) {
-      return false;
-    }
+    return await healthCheckViaDriver(connection);
   }
 }

package/src/database/connection-pool.ts

@@ -4,6 +4,12 @@ import type {
   DatabaseType,
 } from './types';
 import { getRuntime } from '../platform/runtime';
+import {
+  closeViaDriver,
+  createMysqlConnection,
+  createPostgresConnection,
+  resolveDriver,
+} from './driver';
 
 /**
  * 连接池中的连接项
@@ -215,7 +221,7 @@ export class ConnectionPool {
   }
 
   /**
-   * 创建 PostgreSQL 连接（自动感知运行时）
+   * 创建 PostgreSQL 连接（按所选 driver 分流，与运行时平台解耦）
    */
   private async createPostgresConnection(
     config: {
@@ -227,18 +233,16 @@ export class ConnectionPool {
       ssl?: boolean;
     },
   ): Promise<unknown> {
-    const url = `postgres://${config.user}:${config.password}@${config.host}:${config.port}/${config.database}`;
-    if (getRuntime().engine === 'bun') {
-      const { SQL } = await import('bun');
-      return new SQL(url, { max: 1, tls: config.ssl ?? false });
-    }
-    // Node.js：使用 postgres 包
-    const postgres = require('postgres') as typeof import('postgres');
-    return postgres(url, { max: 1, ssl: config.ssl ? 'require' : false });
+    const driver = resolveDriver(
+      'postgres',
+      this.config.type === 'postgres' ? this.config.driver : undefined,
+      getRuntime().engine,
+    );
+    return await createPostgresConnection(config, driver);
   }
 
   /**
-   * 创建 MySQL 连接（自动感知运行时）
+   * 创建 MySQL 连接（按所选 driver 分流，与运行时平台解耦）
    */
   private async createMysqlConnection(
     config: {
@@ -249,21 +253,12 @@ export class ConnectionPool {
       password: string;
     },
   ): Promise<unknown> {
-    if (getRuntime().engine === 'bun') {
-      const url = `mysql://${config.user}:${config.password}@${config.host}:${config.port}/${config.database}`;
-      const { SQL } = await import('bun');
-      return new SQL(url, { max: 1 });
-    }
-    // Node.js：使用 mysql2 包
-    const mysql2 = require('mysql2/promise') as typeof import('mysql2/promise');
-    const conn = await mysql2.createConnection({
-      host: config.host,
-      port: config.port,
-      database: config.database,
-      user: config.user,
-      password: config.password,
-    });
-    return conn;
+    const driver = resolveDriver(
+      'mysql',
+      this.config.type === 'mysql' ? this.config.driver : undefined,
+      getRuntime().engine,
+    );
+    return await createMysqlConnection(config, driver);
   }
 
   /**
@@ -295,35 +290,17 @@ export class ConnectionPool {
   }
 
   /**
-   * 关闭 PostgreSQL 连接（Bun.SQL 会自动管理连接）
+   * 关闭 PostgreSQL 连接（按连接 driver tag 分流：bun-sql → close()，postgres → end()）
    */
-  private async closePostgresConnection(_connection: unknown): Promise<void> {
-    // Bun.SQL 会自动管理连接池，这里不需要手动关闭
-    // 如果需要强制关闭，可以调用 connection.close()
-    if (
-      _connection &&
-      typeof _connection === 'object' &&
-      'close' in _connection &&
-      typeof (_connection as { close: () => void }).close === 'function'
-    ) {
-      (_connection as { close: () => void }).close();
-    }
+  private async closePostgresConnection(connection: unknown): Promise<void> {
+    await closeViaDriver(connection);
   }
 
   /**
-   * 关闭 MySQL 连接（Bun.SQL 会自动管理连接）
+   * 关闭 MySQL 连接（按连接 driver tag 分流：bun-sql → close()，mysql2 → end()）
    */
-  private async closeMysqlConnection(_connection: unknown): Promise<void> {
-    // Bun.SQL 会自动管理连接池，这里不需要手动关闭
-    // 如果需要强制关闭，可以调用 connection.close()
-    if (
-      _connection &&
-      typeof _connection === 'object' &&
-      'close' in _connection &&
-      typeof (_connection as { close: () => void }).close === 'function'
-    ) {
-      (_connection as { close: () => void }).close();
-    }
+  private async closeMysqlConnection(connection: unknown): Promise<void> {
+    await closeViaDriver(connection);
   }
 
   /**