fdb2 1.0.37 → 1.0.39

package/dist/server/model/ddl-spec.d.ts

@@ -0,0 +1,163 @@
+/**
+ * DDL 契约（单一事实来源）
+ *
+ * 本文件是「前端表单 <-> 后端 schema 引擎」之间唯一的类型契约，
+ * 前端直接 import 本文件（前端 tsconfig 已包含 server 目录），禁止再复制一份。
+ *
+ * 核心不变式（由 server/core/schema 保证，测试钉死）：
+ *   1. 纯函数性：ChangeSet = f(canonical(原始态), canonical(目标态))，与操作路径无关；
+ *      任何"改了又改回"的 UI 操作序列，diff 结果恒为空（幂等）。
+ *   2. 单归属：每个语义维度只出现在一个桶里——
+ *      列定义在 modified，主键在 primaryKey（列上不存在 isPrimary），改名在 renamed。
+ *   3. 归一化后比较：两侧先投影为 CanonicalTable 再 diff，
+ *      表示差异（''/null/0、大小写、空格、'varchar(255)' vs {type,length}）不产生假 diff。
+ *
+ * 注意：ColumnSpec 有 hasDefault 布尔，解决 ColumnEntity.defaultValue?: any 的三态歧义
+ *      （无法区分「无默认值」/「DEFAULT NULL」/「DEFAULT 0」/「DEFAULT ''」）。
+ */
+/** 默认值语义类别（归一化后的三态+表达式分类） */
+export type DefaultKind = 'none' | 'null' | 'literal' | 'expression';
+/**
+ * 目标列定义（前端表单 -> 后端）
+ * 前端负责把 UI 状态整理成该结构；不发送 UI 哨兵值（如 '__custom__'），
+ * 自定义类型直接放 customType。
+ */
+export interface ColumnSpec {
+    /** 列名（原样，不去大小写化——标识符匹配按精确名） */
+    name: string;
+    /** 基础类型名，如 VARCHAR / DECIMAL（大小写均可，后端归一为大写比较） */
+    type: string;
+    /** 完整自定义类型串，如 ENUM('a','b')、DECIMAL(20,0)；非空时忽略 type/length/precision/scale */
+    customType?: string;
+    /** 字符长度（string/number 均可，''/null 归一为未设置） */
+    length?: number | string | null;
+    /** 数值精度（precision=总位数；scale=小数位数。注意与 scale 区分） */
+    precision?: number | string | null;
+    /** 小数位数（DECIMAL(10,0) 的 0 必须保留，不得因假值被丢弃） */
+    scale?: number | string | null;
+    /** 是否允许 NULL */
+    nullable: boolean;
+    /** 是否有默认值。true 时以 defaultValue 文本为准（可为 ''，表示 DEFAULT ''） */
+    hasDefault: boolean;
+    /** 默认值文本；'NULL' 视为 DEFAULT NULL；函数/表达式按 expression 归类 */
+    defaultValue?: string | null;
+    /** 是否自增（原始意图；生效与否由后端按「必须依附主键」clamp） */
+    autoIncrement?: boolean;
+    /** 注释 */
+    comment?: string;
+}
+/** 目标表定义（前端表单 -> 后端） */
+export interface TableSpec {
+    name: string;
+    comment?: string;
+    columns: ColumnSpec[];
+    /**
+     * 表级主键（复合主键按序）。主键不挂在列上——这是单归属的关键：
+     * 勾选/取消主键只改这个数组，绝不产生列级 modified 记账。
+     */
+    primaryKey: string[];
+}
+/** 归一化后的列（比较用的中间形状，与来源表示无关） */
+export interface CanonicalColumn {
+    name: string;
+    /** 大写、去空格的基础类型；自定义类型为原样 trim 的完整串 */
+    baseType: string;
+    length?: number;
+    precision?: number;
+    scale?: number;
+    nullable: boolean;
+    defaultKind: DefaultKind;
+    /** literal: 归一后的字面量文本；expression: 大写 trim 的表达式串；其余为空 */
+    defaultText: string;
+    /** 原始自增意图（不做 clamp，供"加主键时恢复自增"使用） */
+    rawAutoIncrement: boolean;
+    /** clamp 后的自增：rawAutoIncrement 且列在主键中 且 类型支持 */
+    effectiveAutoIncrement: boolean;
+    /** trim 后的注释，无注释为 '' */
+    comment: string;
+}
+/** 归一化后的表（diff 的两个输入） */
+export interface CanonicalTable {
+    name: string;
+    comment: string;
+    columns: CanonicalColumn[];
+    /** 主键列名（按序） */
+    primaryKey: string[];
+}
+/** 列级被修改的维度（不含 name、不含主键） */
+export type ColumnModifiedField = 'type' | 'nullable' | 'default' | 'comment' | 'autoIncrement';
+export interface ColumnModification {
+    /** 以目标列名为准 */
+    name: string;
+    /** 恰好发生变化的维度（空数组不可能出现） */
+    fields: ColumnModifiedField[];
+    before: CanonicalColumn;
+    after: CanonicalColumn;
+}
+export interface ColumnRename {
+    from: string;
+    to: string;
+    /** 改名的同时定义也变了（由方言层合并为 RENAME+MODIFY / CHANGE COLUMN） */
+    definitionChanged: boolean;
+    modifiedFields: ColumnModifiedField[];
+}
+/**
+ * 表结构差异（互斥且完备）：
+ * 任一列名至多出现在 added / dropped / renamed / modified 之一；
+ * 主键变更独立于列桶；空 ChangeSet ⟺ 两表归一化后等价。
+ */
+export interface TableChangeSet {
+    rename: {
+        from: string;
+        to: string;
+    } | null;
+    comment: {
+        from: string;
+        to: string;
+    } | null;
+    added: CanonicalColumn[];
+    /** 被删除的原始列名（未被识别为改名的一侧） */
+    dropped: string[];
+    renamed: ColumnRename[];
+    modified: ColumnModification[];
+    /** 幸存列的相对顺序是否变化（SQLite 重建表等场景需要） */
+    orderChanged: boolean;
+    /** 目标完整列序（重建表时使用） */
+    columnOrder: string[];
+    primaryKey: {
+        from: string[];
+        to: string[];
+    } | null;
+}
+/** ChangeSet 是否为空（预览/保存按钮的「没有检测到任何修改」统一判据） */
+export declare function isEmptyChangeSet(cs: TableChangeSet): boolean;
+/** 方言 DDL 能力（capabilities 接口的返回；前端据此渲染 UI，不再硬编码方言表） */
+export interface DdlCapability {
+    createTable: boolean;
+    alterTable: boolean;
+    dropTable: boolean;
+    renameTable: boolean;
+    alterColumn: boolean;
+    renameColumn: boolean;
+    alterPrimaryKey: boolean;
+    tableComment: boolean;
+    columnComment: boolean;
+    /** native=原生 ALTER；rebuild=需重建表（SQLite）；unsupported=不支持（MongoDB） */
+    alterStrategy: 'native' | 'rebuild' | 'unsupported';
+    quoteStyle: 'backtick' | 'double' | 'bracket';
+}
+/** 预览结果：纯计算，不触碰数据库（建表场景无 diff，changeSet 为 null） */
+export interface DdlPreview {
+    statements: string[];
+    preview: string;
+    changeSet: TableChangeSet | null;
+}
+/** 执行结果 */
+export interface DdlExecuteResult {
+    statements: string[];
+    /** 执行时后端重新读取的实时结构与前端 baseline 不一致时拒绝执行（409） */
+    conflict?: {
+        reason: string;
+    };
+}
+//# sourceMappingURL=ddl-spec.d.ts.map

package/dist/server/model/ddl-spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ddl-spec.d.ts","sourceRoot":"","sources":["../../../server/model/ddl-spec.ts"],"names":[],"mappings":"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"}

package/dist/server/model/ddl-spec.js

@@ -0,0 +1,32 @@
+"use strict";
+/**
+ * DDL 契约（单一事实来源）
+ *
+ * 本文件是「前端表单 <-> 后端 schema 引擎」之间唯一的类型契约，
+ * 前端直接 import 本文件（前端 tsconfig 已包含 server 目录），禁止再复制一份。
+ *
+ * 核心不变式（由 server/core/schema 保证，测试钉死）：
+ *   1. 纯函数性：ChangeSet = f(canonical(原始态), canonical(目标态))，与操作路径无关；
+ *      任何"改了又改回"的 UI 操作序列，diff 结果恒为空（幂等）。
+ *   2. 单归属：每个语义维度只出现在一个桶里——
+ *      列定义在 modified，主键在 primaryKey（列上不存在 isPrimary），改名在 renamed。
+ *   3. 归一化后比较：两侧先投影为 CanonicalTable 再 diff，
+ *      表示差异（''/null/0、大小写、空格、'varchar(255)' vs {type,length}）不产生假 diff。
+ *
+ * 注意：ColumnSpec 有 hasDefault 布尔，解决 ColumnEntity.defaultValue?: any 的三态歧义
+ *      （无法区分「无默认值」/「DEFAULT NULL」/「DEFAULT 0」/「DEFAULT ''」）。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isEmptyChangeSet = isEmptyChangeSet;
+/** ChangeSet 是否为空（预览/保存按钮的「没有检测到任何修改」统一判据） */
+function isEmptyChangeSet(cs) {
+    return (cs.rename === null &&
+        cs.comment === null &&
+        cs.added.length === 0 &&
+        cs.dropped.length === 0 &&
+        cs.renamed.length === 0 &&
+        cs.modified.length === 0 &&
+        !cs.orderChanged &&
+        cs.primaryKey === null);
+}
+//# sourceMappingURL=ddl-spec.js.map

package/dist/server/model/ddl-spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ddl-spec.js","sourceRoot":"","sources":["../../../server/model/ddl-spec.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;GAgBG;;AAqHH,4CAWC;AAZD,8CAA8C;AAC9C,SAAgB,gBAAgB,CAAC,EAAkB;IACjD,OAAO,CACL,EAAE,CAAC,MAAM,KAAK,IAAI;QAClB,EAAE,CAAC,OAAO,KAAK,IAAI;QACnB,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;QACrB,EAAE,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;QACvB,EAAE,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;QACvB,EAAE,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;QACxB,CAAC,EAAE,CAAC,YAAY;QAChB,EAAE,CAAC,UAAU,KAAK,IAAI,CACvB,CAAC;AACJ,CAAC"}

package/dist/server/model/ddl-spec.ts

@@ -0,0 +1,175 @@
+/**
+ * DDL 契约（单一事实来源）
+ *
+ * 本文件是「前端表单 <-> 后端 schema 引擎」之间唯一的类型契约，
+ * 前端直接 import 本文件（前端 tsconfig 已包含 server 目录），禁止再复制一份。
+ *
+ * 核心不变式（由 server/core/schema 保证，测试钉死）：
+ *   1. 纯函数性：ChangeSet = f(canonical(原始态), canonical(目标态))，与操作路径无关；
+ *      任何"改了又改回"的 UI 操作序列，diff 结果恒为空（幂等）。
+ *   2. 单归属：每个语义维度只出现在一个桶里——
+ *      列定义在 modified，主键在 primaryKey（列上不存在 isPrimary），改名在 renamed。
+ *   3. 归一化后比较：两侧先投影为 CanonicalTable 再 diff，
+ *      表示差异（''/null/0、大小写、空格、'varchar(255)' vs {type,length}）不产生假 diff。
+ *
+ * 注意：ColumnSpec 有 hasDefault 布尔，解决 ColumnEntity.defaultValue?: any 的三态歧义
+ *      （无法区分「无默认值」/「DEFAULT NULL」/「DEFAULT 0」/「DEFAULT ''」）。
+ */
+
+/** 默认值语义类别（归一化后的三态+表达式分类） */
+export type DefaultKind = 'none' | 'null' | 'literal' | 'expression';
+
+/**
+ * 目标列定义（前端表单 -> 后端）
+ * 前端负责把 UI 状态整理成该结构；不发送 UI 哨兵值（如 '__custom__'），
+ * 自定义类型直接放 customType。
+ */
+export interface ColumnSpec {
+  /** 列名（原样，不去大小写化——标识符匹配按精确名） */
+  name: string;
+  /** 基础类型名，如 VARCHAR / DECIMAL（大小写均可，后端归一为大写比较） */
+  type: string;
+  /** 完整自定义类型串，如 ENUM('a','b')、DECIMAL(20,0)；非空时忽略 type/length/precision/scale */
+  customType?: string;
+  /** 字符长度（string/number 均可，''/null 归一为未设置） */
+  length?: number | string | null;
+  /** 数值精度（precision=总位数；scale=小数位数。注意与 scale 区分） */
+  precision?: number | string | null;
+  /** 小数位数（DECIMAL(10,0) 的 0 必须保留，不得因假值被丢弃） */
+  scale?: number | string | null;
+  /** 是否允许 NULL */
+  nullable: boolean;
+  /** 是否有默认值。true 时以 defaultValue 文本为准（可为 ''，表示 DEFAULT ''） */
+  hasDefault: boolean;
+  /** 默认值文本；'NULL' 视为 DEFAULT NULL；函数/表达式按 expression 归类 */
+  defaultValue?: string | null;
+  /** 是否自增（原始意图；生效与否由后端按「必须依附主键」clamp） */
+  autoIncrement?: boolean;
+  /** 注释 */
+  comment?: string;
+}
+
+/** 目标表定义（前端表单 -> 后端） */
+export interface TableSpec {
+  name: string;
+  comment?: string;
+  columns: ColumnSpec[];
+  /**
+   * 表级主键（复合主键按序）。主键不挂在列上——这是单归属的关键：
+   * 勾选/取消主键只改这个数组，绝不产生列级 modified 记账。
+   */
+  primaryKey: string[];
+}
+
+/** 归一化后的列（比较用的中间形状，与来源表示无关） */
+export interface CanonicalColumn {
+  name: string;
+  /** 大写、去空格的基础类型；自定义类型为原样 trim 的完整串 */
+  baseType: string;
+  length?: number;
+  precision?: number;
+  scale?: number;
+  nullable: boolean;
+  defaultKind: DefaultKind;
+  /** literal: 归一后的字面量文本；expression: 大写 trim 的表达式串；其余为空 */
+  defaultText: string;
+  /** 原始自增意图（不做 clamp，供"加主键时恢复自增"使用） */
+  rawAutoIncrement: boolean;
+  /** clamp 后的自增：rawAutoIncrement 且列在主键中 且 类型支持 */
+  effectiveAutoIncrement: boolean;
+  /** trim 后的注释，无注释为 '' */
+  comment: string;
+}
+
+/** 归一化后的表（diff 的两个输入） */
+export interface CanonicalTable {
+  name: string;
+  comment: string;
+  columns: CanonicalColumn[];
+  /** 主键列名（按序） */
+  primaryKey: string[];
+}
+
+/** 列级被修改的维度（不含 name、不含主键） */
+export type ColumnModifiedField = 'type' | 'nullable' | 'default' | 'comment' | 'autoIncrement';
+
+export interface ColumnModification {
+  /** 以目标列名为准 */
+  name: string;
+  /** 恰好发生变化的维度（空数组不可能出现） */
+  fields: ColumnModifiedField[];
+  before: CanonicalColumn;
+  after: CanonicalColumn;
+}
+
+export interface ColumnRename {
+  from: string;
+  to: string;
+  /** 改名的同时定义也变了（由方言层合并为 RENAME+MODIFY / CHANGE COLUMN） */
+  definitionChanged: boolean;
+  modifiedFields: ColumnModifiedField[];
+}
+
+/**
+ * 表结构差异（互斥且完备）：
+ * 任一列名至多出现在 added / dropped / renamed / modified 之一；
+ * 主键变更独立于列桶；空 ChangeSet ⟺ 两表归一化后等价。
+ */
+export interface TableChangeSet {
+  rename: { from: string; to: string } | null;
+  comment: { from: string; to: string } | null;
+  added: CanonicalColumn[];
+  /** 被删除的原始列名（未被识别为改名的一侧） */
+  dropped: string[];
+  renamed: ColumnRename[];
+  modified: ColumnModification[];
+  /** 幸存列的相对顺序是否变化（SQLite 重建表等场景需要） */
+  orderChanged: boolean;
+  /** 目标完整列序（重建表时使用） */
+  columnOrder: string[];
+  primaryKey: { from: string[]; to: string[] } | null;
+}
+
+/** ChangeSet 是否为空（预览/保存按钮的「没有检测到任何修改」统一判据） */
+export function isEmptyChangeSet(cs: TableChangeSet): boolean {
+  return (
+    cs.rename === null &&
+    cs.comment === null &&
+    cs.added.length === 0 &&
+    cs.dropped.length === 0 &&
+    cs.renamed.length === 0 &&
+    cs.modified.length === 0 &&
+    !cs.orderChanged &&
+    cs.primaryKey === null
+  );
+}
+
+/** 方言 DDL 能力（capabilities 接口的返回；前端据此渲染 UI，不再硬编码方言表） */
+export interface DdlCapability {
+  createTable: boolean;
+  alterTable: boolean;
+  dropTable: boolean;
+  renameTable: boolean;
+  alterColumn: boolean;
+  renameColumn: boolean;
+  alterPrimaryKey: boolean;
+  tableComment: boolean;
+  columnComment: boolean;
+  /** native=原生 ALTER；rebuild=需重建表（SQLite）；unsupported=不支持（MongoDB） */
+  alterStrategy: 'native' | 'rebuild' | 'unsupported';
+  quoteStyle: 'backtick' | 'double' | 'bracket';
+}
+
+/** 预览结果：纯计算，不触碰数据库（建表场景无 diff，changeSet 为 null） */
+export interface DdlPreview {
+  statements: string[];
+  preview: string;
+  changeSet: TableChangeSet | null;
+}
+
+/** 执行结果 */
+export interface DdlExecuteResult {
+  statements: string[];
+  /** 执行时后端重新读取的实时结构与前端 baseline 不一致时拒绝执行（409） */
+  conflict?: { reason: string };
+}

package/dist/server/service/connection.service.d.ts

@@ -14,6 +14,14 @@ export declare class ConnectionService {
      * 活跃的数据库连接实例
      */
     private activeConnections;
+    /**
+     * 正在建立中的连接（key → Promise）。
+     * 缓存里存的是已建好的 DataSource，同一 key 的并发请求在 await 期间都读不到缓存，
+     * 会各自 new DataSource().initialize()，后写的覆盖先写的——先建的那个池再无引用也
+     * 无法回收，持续累积直到服务端报 ER_CON_COUNT_ERROR(Too many connections)。
+     * 这里登记在途 Promise，让并发请求共享同一次建连。
+     */
+    private pendingConnections;
     constructor();
     /**
      * 初始化服务，创建配置目录
@@ -41,12 +49,24 @@ export declare class ConnectionService {
     deleteConnection(id: string): Promise<void>;
     /**
      * 测试数据库连接
+     *
+     * 当请求带 id 时，优先用服务端已保存的配置补齐客户端未回传的凭据
+     * （远程代理场景下客户端不持有远程库的密码，密码只保存在服务端）。
      */
     testConnection(connection: ConnectionEntity): Promise<boolean>;
     /**
      * 获取活跃的数据库连接
+     *
+     * 并发安全：同一 key 的并发请求共享同一次建连（pendingConnections 去重），
+     * 避免重复建连导致的连接池泄漏（MySQL Too many connections 的主因）。
      */
     getActiveConnection(id: string, database?: string): Promise<DataSource>;
+    /** 建连并登记到缓存；超过容量上限时按 LRU 淘汰最久未使用的连接 */
+    private createAndCacheConnection;
+    /** 按 LRU 把缓存裁剪到上限，淘汰项真正 destroy，避免连接池残留 */
+    private trimCache;
+    /** 销毁连接但不向上抛，避免清理失败影响主流程 */
+    private destroyQuietly;
     /**
      * 关闭数据库连接
      */

package/dist/server/service/connection.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connection.service.d.ts","sourceRoot":"","sources":["../../../server/service/connection.service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAG7D;;;GAGG;AACH,qBAAa,iBAAiB;IAE5B;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IAEpC;;OAEG;IACH,OAAO,CAAC,iBAAiB,CAAsC;;IAM/D;;OAEG;IACG,IAAI;IAIV;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAatD;;OAEG;IACG,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAKrE;;OAEG;IACG,aAAa,CAAC,UAAU,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAoB5E;;OAEG;IACG,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAmBjG;;OAEG;IACG,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBjD;;OAEG;IACG,cAAc,CAAC,UAAU,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC;IAWpE;;OAEG;IACG,mBAAmB,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IA2C7E;;OAEG;IACG,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAanE;;OAEG;IACG,wBAAwB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAenE;;OAEG;IACG,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAW1C;;OAEG;YACW,uBAAuB;IAUrC;;;OAGG;IACG,yBAAyB,CAAC,iBAAiB,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC;IAkB1F;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA4EzB;;OAEG;YACW,eAAe;IAkB7B;;OAEG;IACH,OAAO,CAAC,UAAU;CAGnB"}
+{"version":3,"file":"connection.service.d.ts","sourceRoot":"","sources":["../../../server/service/connection.service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAU7D;;;GAGG;AACH,qBAAa,iBAAiB;IAE5B;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IAEpC;;OAEG;IACH,OAAO,CAAC,iBAAiB,CAAsC;IAE/D;;;;;;OAMG;IACH,OAAO,CAAC,kBAAkB,CAA+C;;IAMzE;;OAEG;IACG,IAAI;IAIV;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAatD;;OAEG;IACG,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAKrE;;OAEG;IACG,aAAa,CAAC,UAAU,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAoB5E;;OAEG;IACG,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAyBjG;;OAEG;IACG,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBjD;;;;;OAKG;IACG,cAAc,CAAC,UAAU,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC;IAkBpE;;;;;OAKG;IACG,mBAAmB,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAgC7E,uCAAuC;YACzB,wBAAwB;IAuBtC,2CAA2C;YAC7B,SAAS;IAUvB,4BAA4B;YACd,cAAc;IAS5B;;OAEG;IACG,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAanE;;OAEG;IACG,wBAAwB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAenE;;OAEG;IACG,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAW1C;;OAEG;YACW,uBAAuB;IAUrC;;;OAGG;IACG,yBAAyB,CAAC,iBAAiB,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC;IAkB1F;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAsFzB;;OAEG;YACW,eAAe;IAkB7B;;OAEG;IACH,OAAO,CAAC,UAAU;CAGnB"}

package/dist/server/service/connection.service.js

@@ -38,6 +38,12 @@ const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const typeorm_1 = require("typeorm");
 const data_dir_1 = require("../utils/data-dir");
+/**
+ * 缓存的连接池数量上限。
+ * 每个池自身还有 connectionLimit 上限（见 getTypeORMOptions），
+ * 二者相乘即本进程对单个库的最大连接数，需留出余量避免撞上服务端 max_connections。
+ */
+const MAX_CACHED_CONNECTIONS = 8;
 /**
  * 数据库连接管理服务
  * 负责管理数据库连接配置和连接实例
@@ -52,6 +58,14 @@ class ConnectionService {
      * 活跃的数据库连接实例
      */
     activeConnections = new Map();
+    /**
+     * 正在建立中的连接（key → Promise）。
+     * 缓存里存的是已建好的 DataSource，同一 key 的并发请求在 await 期间都读不到缓存，
+     * 会各自 new DataSource().initialize()，后写的覆盖先写的——先建的那个池再无引用也
+     * 无法回收，持续累积直到服务端报 ER_CON_COUNT_ERROR(Too many connections)。
+     * 这里登记在途 Promise，让并发请求共享同一次建连。
+     */
+    pendingConnections = new Map();
     constructor() {
         this.configPath = (0, data_dir_1.getDataPath)('connections.json');
     }
@@ -115,6 +129,12 @@ class ConnectionService {
         if (updates.name && connections.find((conn, idx) => conn.name === updates.name && idx !== index)) {
             throw new Error('连接名称已存在');
         }
+        // 空密码不覆盖已保存的密码：
+        // 远程代理场景下客户端不持有远程库的密码（服务端不下发），编辑保存时密码框为空，
+        // 若直接覆盖会把远端的密码清掉。
+        if (updates.password === '' && connections[index].password) {
+            delete updates.password;
+        }
         // @ts-ignore
         connections[index] = { ...connections[index], ...updates, updatedAt: new Date() };
         await this.saveConnections(connections);
@@ -139,10 +159,20 @@ class ConnectionService {
     }
     /**
      * 测试数据库连接
+     *
+     * 当请求带 id 时，优先用服务端已保存的配置补齐客户端未回传的凭据
+     * （远程代理场景下客户端不持有远程库的密码，密码只保存在服务端）。
      */
     async testConnection(connection) {
         try {
-            const tempDataSource = await this.createTypeORMDataSource(connection);
+            let target = connection;
+            if (connection.id) {
+                const stored = await this.getConnectionById(connection.id);
+                if (stored) {
+                    target = { ...stored, ...connection, password: connection.password || stored.password };
+                }
+            }
+            const tempDataSource = await this.createTypeORMDataSource(target);
             await tempDataSource.query('SELECT 1');
             await tempDataSource.destroy();
             return true;
@@ -153,33 +183,42 @@ class ConnectionService {
     }
     /**
      * 获取活跃的数据库连接
+     *
+     * 并发安全：同一 key 的并发请求共享同一次建连（pendingConnections 去重），
+     * 避免重复建连导致的连接池泄漏（MySQL Too many connections 的主因）。
      */
     async getActiveConnection(id, database) {
         const key = database ? `${id}_${database}` : id;
-        if (this.activeConnections.has(key)) {
-            const db = this.activeConnections.get(key);
-            // 检查连接是否仍然有效
-            if (db?.isInitialized) {
-                return db;
-            }
-            else {
-                // 连接已关闭，从缓存中移除
+        // 命中缓存：可用则复用，并刷新 LRU 位置（避免正在使用的热点连接被优先淘汰）
+        const cached = this.activeConnections.get(key);
+        if (cached) {
+            if (cached.isInitialized) {
                 this.activeConnections.delete(key);
+                this.activeConnections.set(key, cached);
+                return cached;
             }
+            // 连接已失效：必须销毁后再移除，否则它持有的连接池会泄漏
+            this.activeConnections.delete(key);
+            await this.destroyQuietly(cached, key);
         }
-        // 连接池大小限制，防止连接数无限增长
-        if (this.activeConnections.size >= 10) {
-            // 关闭最旧的连接
-            const oldestKey = this.activeConnections.keys().next().value || '';
-            const oldestConnection = this.activeConnections.get(oldestKey);
-            try {
-                await oldestConnection?.destroy();
-            }
-            catch (error) {
-                console.error(`关闭旧连接 ${oldestKey} 失败:`, error);
+        // 并发去重：同一 key 已在建连中，直接复用同一个 Promise
+        const pending = this.pendingConnections.get(key);
+        if (pending)
+            return pending;
+        const task = this.createAndCacheConnection(key, id, database);
+        this.pendingConnections.set(key, task);
+        try {
+            return await task;
+        }
+        finally {
+            // 仅清理自己登记的那一个（可能已被同 key 的后续任务覆盖）
+            if (this.pendingConnections.get(key) === task) {
+                this.pendingConnections.delete(key);
             }
-            this.activeConnections.delete(oldestKey);
         }
+    }
+    /** 建连并登记到缓存；超过容量上限时按 LRU 淘汰最久未使用的连接 */
+    async createAndCacheConnection(key, id, database) {
         const connectionConfig = await this.getConnectionById(id);
         if (!connectionConfig) {
             throw new Error('连接配置不存在');
@@ -191,8 +230,34 @@ class ConnectionService {
         };
         const dataSource = await this.createTypeORMDataSource(updatedConnectionConfig);
         this.activeConnections.set(key, dataSource);
+        // 必须「注册后再裁剪」：若在 await 建连之前检查容量，并发请求会在同一时刻
+        // 全部通过检查（此刻谁都还没 set 进缓存），缓存就会突破上限。
+        // set 之后 size 才是真实值；新连接位于 LRU 末尾，裁剪不会误伤它。
+        await this.trimCache();
         return dataSource;
     }
+    /** 按 LRU 把缓存裁剪到上限，淘汰项真正 destroy，避免连接池残留 */
+    async trimCache() {
+        while (this.activeConnections.size > MAX_CACHED_CONNECTIONS) {
+            const oldestKey = this.activeConnections.keys().next().value;
+            if (!oldestKey)
+                break;
+            const oldest = this.activeConnections.get(oldestKey);
+            this.activeConnections.delete(oldestKey);
+            await this.destroyQuietly(oldest, oldestKey);
+        }
+    }
+    /** 销毁连接但不向上抛，避免清理失败影响主流程 */
+    async destroyQuietly(dataSource, label) {
+        if (!dataSource)
+            return;
+        try {
+            await dataSource.destroy();
+        }
+        catch (error) {
+            console.error(`关闭连接 ${label} 失败:`, error);
+        }
+    }
     /**
      * 关闭数据库连接
      */
@@ -278,6 +343,7 @@ class ConnectionService {
      * 获取TypeORM连接配置
      */
     getTypeORMOptions(connectionConfig) {
+        const userOptions = (connectionConfig.options || {});
         const baseOptions = {
             type: connectionConfig.type,
             host: connectionConfig.host,
@@ -291,11 +357,17 @@ class ConnectionService {
             // 全局安装时 Node 会解析到系统中全局遗留的 mysql 包，该老包不支持 MySQL 8 的
             // caching_sha2_password，导致 ER_NOT_SUPPORTED_AUTH_MODE。显式指定 mysql2 可彻底规避。
             connectorPackage: 'mysql2',
-            // 关键配置：开启多语句执行
+            ...userOptions,
+            // extra 必须放在 ...userOptions 之后并做合并：
+            // 原先 extra 在展开之前，connectionConfig.options.extra 会把它整体顶掉，
+            // 导致 multipleStatements 静默失效。
+            // connectionLimit 显式收敛单池上限（mysql2 默认 10），叠加最多 MAX_CACHED_CONNECTIONS
+            // 个池后仍远小于常见的 max_connections(151)，避免 Too many connections。
             extra: {
-                multipleStatements: true
-            },
-            ...connectionConfig.options
+                multipleStatements: true,
+                connectionLimit: 5,
+                ...(userOptions.extra || {})
+            }
         };
         // 根据数据库类型调整配置
         switch (connectionConfig.type.toLowerCase()) {
@@ -316,7 +388,9 @@ class ConnectionService {
                 return {
                     ...baseOptions,
                     type: 'postgres',
-                    ssl: connectionConfig.options?.ssl || false
+                    ssl: connectionConfig.options?.ssl || false,
+                    // pg 池上限字段是 max（不是 mysql2 的 connectionLimit）
+                    extra: { ...(baseOptions.extra || {}), max: 5 }
                 };
             case 'oracle':
                 return {