midway-fatcms 0.0.19 → 0.0.20

package/src/libs/crud-pro-quick/fixSoftDelete.ts

@@ -1,8 +1,7 @@
-import { KeysOfSimpleSQL } from "@/libs/crud-pro/models/keys";
-import { IRequestModel, IVisitor } from "@/libs/crud-pro/interfaces";
-import { IRequestCfgModel2, ICommonStandardColumns, ICommonStandardColumns2 } from "./models";
-import { DateTimeUtils } from "@/libs/crud-pro/utils/DateTimeUtils";
-
+import { KeysOfSimpleSQL } from '@/libs/crud-pro/models/keys';
+import { IRequestModel, IVisitor } from '@/libs/crud-pro/interfaces';
+import { IRequestCfgModel2, ICommonStandardColumns, ICommonStandardColumns2 } from './models';
+import { DateTimeUtils } from '@/libs/crud-pro/utils/DateTimeUtils';
 
 /**
  * 软删除处理函数
@@ -18,14 +17,7 @@ import { DateTimeUtils } from "@/libs/crud-pro/utils/DateTimeUtils";
  * @param params 请求参数（会被修改）
  * @param visitor 获取当前用户信息的函数（用于软删除时记录删除人）
  */
-function fixSoftDelete1(
-  oldSqlSimpleName: KeysOfSimpleSQL,
-  cfgModel: IRequestCfgModel2,
-  params: IRequestModel,
-  visitor?: IVisitor
-): void {
-
-
+function fixSoftDelete1(oldSqlSimpleName: KeysOfSimpleSQL, cfgModel: IRequestCfgModel2, params: IRequestModel, visitor?: IVisitor): void {
   // INSERT 操作：刚插入的数据，肯定是未删除的
   if (KeysOfSimpleSQL.SIMPLE_INSERT === oldSqlSimpleName) {
     if (!params.data) {
@@ -38,12 +30,10 @@ function fixSoftDelete1(
   // DELETE 操作：如果是软删除，修改为 UPDATE 语句
   // 标准软删除：deleted_at 字段为 0 代表未删除，有任意时间戳代表已删除
   if (KeysOfSimpleSQL.SIMPLE_DELETE === oldSqlSimpleName) {
-
     if (!params.condition || Object.keys(params.condition).length === 0) {
       throw new Error('执行删除操作，必须指定删除条件');
     }
 
-
     // 在原有 data 对象上添加软删除字段
     if (!params.data) {
       params.data = {};
@@ -57,10 +47,7 @@ function fixSoftDelete1(
   }
 
   // QUERY 操作：强制查询未删除的记录
-  if (KeysOfSimpleSQL.SIMPLE_QUERY_ONE === oldSqlSimpleName
-    || KeysOfSimpleSQL.SIMPLE_QUERY === oldSqlSimpleName
-    || KeysOfSimpleSQL.SIMPLE_QUERY_PAGE === oldSqlSimpleName) {
-
+  if (KeysOfSimpleSQL.SIMPLE_QUERY_ONE === oldSqlSimpleName || KeysOfSimpleSQL.SIMPLE_QUERY === oldSqlSimpleName || KeysOfSimpleSQL.SIMPLE_QUERY_PAGE === oldSqlSimpleName) {
     if (!params.condition) {
       params.condition = {};
     }
@@ -68,15 +55,7 @@ function fixSoftDelete1(
   }
 }
 
-
-function fixSoftDelete2(
-  oldSqlSimpleName: KeysOfSimpleSQL,
-  cfgModel: IRequestCfgModel2,
-  params: IRequestModel,
-  visitor?: IVisitor
-): void {
-
-
+function fixSoftDelete2(oldSqlSimpleName: KeysOfSimpleSQL, cfgModel: IRequestCfgModel2, params: IRequestModel, visitor?: IVisitor): void {
   // INSERT 操作：刚插入的数据，肯定是未删除的
   if (KeysOfSimpleSQL.SIMPLE_INSERT === oldSqlSimpleName) {
     if (!params.data) {
@@ -88,12 +67,10 @@ function fixSoftDelete2(
 
   // DELETE 操作：如果是软删除，修改为 UPDATE 语句
   if (KeysOfSimpleSQL.SIMPLE_DELETE === oldSqlSimpleName) {
-
     if (!params.condition || Object.keys(params.condition).length === 0) {
       throw new Error('执行删除操作，必须指定删除条件');
     }
 
-
     // 在原有 data 对象上添加软删除字段
     if (!params.data) {
       params.data = {};
@@ -108,10 +85,7 @@ function fixSoftDelete2(
   }
 
   // QUERY 操作：强制查询未删除的记录
-  if (KeysOfSimpleSQL.SIMPLE_QUERY_ONE === oldSqlSimpleName
-    || KeysOfSimpleSQL.SIMPLE_QUERY === oldSqlSimpleName
-    || KeysOfSimpleSQL.SIMPLE_QUERY_PAGE === oldSqlSimpleName) {
-
+  if (KeysOfSimpleSQL.SIMPLE_QUERY_ONE === oldSqlSimpleName || KeysOfSimpleSQL.SIMPLE_QUERY === oldSqlSimpleName || KeysOfSimpleSQL.SIMPLE_QUERY_PAGE === oldSqlSimpleName) {
     if (!params.condition) {
       params.condition = {};
     }
@@ -119,8 +93,6 @@ function fixSoftDelete2(
   }
 }
 
-
-
 /**
  * 软删除处理函数
  *
@@ -129,14 +101,7 @@ function fixSoftDelete2(
  * @param params 请求参数（会被修改）
  * @param visitor 获取当前用户信息的函数（用于软删除时记录删除人）
  */
-function fixSoftDelete(
-  oldSqlSimpleName: KeysOfSimpleSQL,
-  cfgModel: IRequestCfgModel2,
-  params: IRequestModel,
-  visitor?: IVisitor
-): void {
-
-
+function fixSoftDelete(oldSqlSimpleName: KeysOfSimpleSQL, cfgModel: IRequestCfgModel2, params: IRequestModel, visitor?: IVisitor): void {
   if (cfgModel.enableSoftDelete === true || cfgModel.enableSoftDelete === 'soft') {
     fixSoftDelete1(oldSqlSimpleName, cfgModel, params, visitor);
     return;
@@ -146,11 +111,6 @@ function fixSoftDelete(
     fixSoftDelete2(oldSqlSimpleName, cfgModel, params, visitor);
     return;
   }
-
 }
 
-
-export {
-  fixSoftDelete,
-};
-
+export { fixSoftDelete };

package/src/service/curd/CurdMixService.ts

@@ -10,7 +10,7 @@ import { IRequestCfgModel2 } from '@/models/bizmodels';
 import { CurdMixByLinkToCustomService } from './CurdMixByLinkToCustomService';
 // import { SqlDbType } from '@/libs/crud-pro/models/keys';
 import { ExecuteContext, IExecuteContextCustom } from '@/libs/crud-pro/models/ExecuteContext';
-import { ShardingBase } from "@/libs/crud-sharding";
+import { ShardingBase } from '@/libs/crud-sharding';
 import { IGetQuickCrudParam, IGetShardingCrudParam } from './CurdProService';
 
 export interface ILinkColumnRelationParam {
@@ -50,7 +50,6 @@ export class CurdMixService {
     return this.curdProService.executeCrudByCfg(reqJson, cfgModel);
   }
 
-
   // /**
   //  * @deprecated 请使用 getQuickCrud 替代
   //  * @param sqlDatabase
@@ -67,13 +66,11 @@ export class CurdMixService {
     return this.curdProService.getQuickCrud(param);
   }
 
-
   public getShardingCrud(param: IGetShardingCrudParam): ShardingBase {
     this.prepare();
     return this.curdProService.getShardingCrud(param);
   }
 
-
   async executeSQL(sqlCfgModel: ISqlCfgModel): Promise<ExecuteSQLResult> {
     this.prepare();
     return this.curdProService.executeSQL(sqlCfgModel);

package/src/service/curd/CurdProService.ts

@@ -20,7 +20,7 @@ import { CrudProQuick } from '@/libs/crud-pro-quick';
 import { ShardingBase, ShardingByTimeCrud, ShardingByHashCrud, ShardingByKeyCrud, ShardingByCustomCrud, ShardingType, IShardingConfig } from '@/libs/crud-sharding';
 import { fixCfgModel } from './fixCfgModel';
 import { GLOBAL_STATIC_CONFIG } from '@/libs/global-config/global-config';
-import { fixSoftDelete } from "@/libs/crud-pro-quick/fixSoftDelete";
+import { fixSoftDelete } from '@/libs/crud-pro-quick/fixSoftDelete';
 
 /**
  * getQuickCrud 参数接口
@@ -321,7 +321,6 @@ export class CurdProService extends BaseService {
     return await curdPro.executeCrudByCfg(reqJson, cfgModel);
   }
 
-
   /**
    * 获取 CrudProQuick 工具类
    *
@@ -431,14 +430,14 @@ export class CurdProService extends BaseService {
     return curdPro.getAllTableInfos(query, options);
   }
 
-
   public async loadTableMetaCache(ctx?: any): Promise<void> {
     const { SystemDbName, SystemDbType } = GLOBAL_STATIC_CONFIG.getConfig();
-    await this.getAllTableInfos({
-      sqlDatabase: SystemDbName,
-      sqlDbType: SystemDbType,
-    }, { skipCache: true });
+    await this.getAllTableInfos(
+      {
+        sqlDatabase: SystemDbName,
+        sqlDbType: SystemDbType,
+      },
+      { skipCache: true }
+    );
   }
 }
-
-

package/src/service/curd/fixCfgModel.ts

@@ -1,145 +1,145 @@
-import * as _ from 'lodash';
-import { CTX_VISITOR_ACCOUNT_TYPE, CTX_VISITOR_AVATAR, CTX_VISITOR_ID, CTX_VISITOR_NICKNAME, IRequestCfgModel2 } from '@/models/bizmodels';
-import { KeysOfSimpleSQL } from '@/libs/crud-pro/models/keys';
-
-function isSimpleQuery(sqlSimpleName: KeysOfSimpleSQL): boolean {
-  return sqlSimpleName === KeysOfSimpleSQL.SIMPLE_QUERY || sqlSimpleName === KeysOfSimpleSQL.SIMPLE_QUERY_COUNT || sqlSimpleName === KeysOfSimpleSQL.SIMPLE_QUERY_PAGE || sqlSimpleName === KeysOfSimpleSQL.SIMPLE_QUERY_ONE;
-}
-
-function fixCfgModel(cfgModel: IRequestCfgModel2) {
-  if (!cfgModel.method) {
-    cfgModel.method = 'anonymous';
-  }
-
-  if (!cfgModel.updateCfg) {
-    cfgModel.updateCfg = {};
-  }
-
-  const sqlSimpleName = cfgModel.sqlSimpleName;
-
-  const enableStandardUpdateCfg = cfgModel.enableStandardUpdateCfg; // 用于设置data字段
-  const enableStandardUpdateCfgCondition = cfgModel.enableStandardUpdateCfgCondition; // 用于设置condition字段
-
-  // 彻底关闭
-  if (enableStandardUpdateCfg === false) {
-    return;
-  }
-
-  const getDataCfgArray = () => {
-    // 明确有配置
-    if (Array.isArray(enableStandardUpdateCfg)) {
-      if (enableStandardUpdateCfg.includes('null')) {
-        return [];
-      }
-      return enableStandardUpdateCfg;
-    }
-    // update 、insert 添加 by
-    return ['by', 'at']; // 创建/修改语句默认添加by
-  };
-
-  const getConditionCfgArray = () => {
-    // 明确有配置
-    if (Array.isArray(enableStandardUpdateCfgCondition)) {
-      if (enableStandardUpdateCfgCondition.includes('null')) {
-        return [];
-      }
-      return enableStandardUpdateCfgCondition;
-    }
-    return [];
-  };
-
-  const dataCfgArray = getDataCfgArray();
-  const conditionCfgArray = getConditionCfgArray();
-
-  const mapping: Record<string, any> = {
-    'condition.created_by': { contextAsString: CTX_VISITOR_ID },
-    'condition.created_account_type': { contextAsString: CTX_VISITOR_ACCOUNT_TYPE },
-
-    'data.created_at': { functionName: 'getCurrentTimeString' },
-    'data.created_by': { contextAsString: CTX_VISITOR_ID },
-    'data.created_avatar': { contextAsString: CTX_VISITOR_AVATAR },
-    'data.created_nickname': { contextAsString: CTX_VISITOR_NICKNAME },
-    'data.created_account_type': { contextAsString: CTX_VISITOR_ACCOUNT_TYPE },
-
-    'data.modified_at': { functionName: 'getCurrentTimeString' },
-    'data.modified_by': { contextAsString: CTX_VISITOR_ID },
-    'data.modified_avatar': { contextAsString: CTX_VISITOR_AVATAR },
-    'data.modified_nickname': { contextAsString: CTX_VISITOR_NICKNAME },
-    'data.modified_account_type': { contextAsString: CTX_VISITOR_ACCOUNT_TYPE },
-  };
-
-  const buildUpdateCfgBy = (cfgArray: string[], prefix: string): any => {
-    const obj: any = {};
-    if (Array.isArray(cfgArray)) {
-      for (let i = 0; i < cfgArray.length; i++) {
-        const suffix = cfgArray[i];
-        if (suffix) {
-          const key = `${prefix}_${suffix}`;
-          if (mapping[key]) {
-            obj[key] = mapping[key];
-          }
-        }
-      }
-    }
-    return obj;
-  };
-
-  // 查询语句
-  if (isSimpleQuery(sqlSimpleName)) {
-    const updateCfgObj = buildUpdateCfgBy(conditionCfgArray, 'condition.created'); // 查询用户本人创建的
-    _.merge(cfgModel.updateCfg, updateCfgObj);
-  }
-
-  // 删除语句
-  if (sqlSimpleName === KeysOfSimpleSQL.SIMPLE_DELETE) {
-    const updateCfgObj = buildUpdateCfgBy(conditionCfgArray, 'condition.created'); // 删除用户本人创建的
-    _.merge(cfgModel.updateCfg, updateCfgObj);
-  }
-
-  // 插入语句
-  if (sqlSimpleName === KeysOfSimpleSQL.SIMPLE_INSERT) {
-    const updateCfgObj1 = buildUpdateCfgBy(dataCfgArray, 'data.created');
-    _.merge(cfgModel.updateCfg, updateCfgObj1);
-
-    // 启用: 雪花ID
-    if (dataCfgArray.includes('idBySnowflakeId')) {
-      _.merge(cfgModel.updateCfg, {
-        'data.id': { functionName: 'generateSnowflakeId' },
-      });
-    }
-
-    // 启用: 扩展的雪花ID： -128bit，base58（建议数据库varchar（24））
-    if (dataCfgArray.includes('idBySnowflakeIdExt')) {
-      _.merge(cfgModel.updateCfg, {
-        'data.id': { functionName: 'generateSnowflakeIdExt' },
-      });
-    }
-
-    // 启用: UUID
-    if (dataCfgArray.includes('idByUUID')) {
-      _.merge(cfgModel.updateCfg, {
-        'data.id': { functionName: 'uuid' },
-      });
-    }
-  }
-
-  // 更新语句
-  if (sqlSimpleName === KeysOfSimpleSQL.SIMPLE_UPDATE) {
-    const updateCfgObj1 = buildUpdateCfgBy(dataCfgArray, 'data.modified');
-    const updateCfgObj2 = buildUpdateCfgBy(conditionCfgArray, 'condition.created'); // 更新用户本人创建的
-    _.merge(cfgModel.updateCfg, updateCfgObj1);
-    _.merge(cfgModel.updateCfg, updateCfgObj2);
-  }
-
-  // 插入或更新
-  if (sqlSimpleName === KeysOfSimpleSQL.SIMPLE_INSERT_OR_UPDATE || sqlSimpleName === KeysOfSimpleSQL.SIMPLE_INSERT_ON_DUPLICATE_UPDATE) {
-    const updateCfgObj1 = buildUpdateCfgBy(dataCfgArray, 'data.created');
-    const updateCfgObj2 = buildUpdateCfgBy(dataCfgArray, 'data.modified');
-    const updateCfgObj3 = buildUpdateCfgBy(conditionCfgArray, 'condition.created'); // 更新用户本人创建的
-    _.merge(cfgModel.updateCfg, updateCfgObj1);
-    _.merge(cfgModel.updateCfg, updateCfgObj2);
-    _.merge(cfgModel.updateCfg, updateCfgObj3);
-  }
-}
-
-export { fixCfgModel };
+import * as _ from 'lodash';
+import { CTX_VISITOR_ACCOUNT_TYPE, CTX_VISITOR_AVATAR, CTX_VISITOR_ID, CTX_VISITOR_NICKNAME, IRequestCfgModel2 } from '@/models/bizmodels';
+import { KeysOfSimpleSQL } from '@/libs/crud-pro/models/keys';
+
+function isSimpleQuery(sqlSimpleName: KeysOfSimpleSQL): boolean {
+  return sqlSimpleName === KeysOfSimpleSQL.SIMPLE_QUERY || sqlSimpleName === KeysOfSimpleSQL.SIMPLE_QUERY_COUNT || sqlSimpleName === KeysOfSimpleSQL.SIMPLE_QUERY_PAGE || sqlSimpleName === KeysOfSimpleSQL.SIMPLE_QUERY_ONE;
+}
+
+function fixCfgModel(cfgModel: IRequestCfgModel2) {
+  if (!cfgModel.method) {
+    cfgModel.method = 'anonymous';
+  }
+
+  if (!cfgModel.updateCfg) {
+    cfgModel.updateCfg = {};
+  }
+
+  const sqlSimpleName = cfgModel.sqlSimpleName;
+
+  const enableStandardUpdateCfg = cfgModel.enableStandardUpdateCfg; // 用于设置data字段
+  const enableStandardUpdateCfgCondition = cfgModel.enableStandardUpdateCfgCondition; // 用于设置condition字段
+
+  // 彻底关闭
+  if (enableStandardUpdateCfg === false) {
+    return;
+  }
+
+  const getDataCfgArray = () => {
+    // 明确有配置
+    if (Array.isArray(enableStandardUpdateCfg)) {
+      if (enableStandardUpdateCfg.includes('null')) {
+        return [];
+      }
+      return enableStandardUpdateCfg;
+    }
+    // update 、insert 添加 by
+    return ['by', 'at']; // 创建/修改语句默认添加by
+  };
+
+  const getConditionCfgArray = () => {
+    // 明确有配置
+    if (Array.isArray(enableStandardUpdateCfgCondition)) {
+      if (enableStandardUpdateCfgCondition.includes('null')) {
+        return [];
+      }
+      return enableStandardUpdateCfgCondition;
+    }
+    return [];
+  };
+
+  const dataCfgArray = getDataCfgArray();
+  const conditionCfgArray = getConditionCfgArray();
+
+  const mapping: Record<string, any> = {
+    'condition.created_by': { contextAsString: CTX_VISITOR_ID },
+    'condition.created_account_type': { contextAsString: CTX_VISITOR_ACCOUNT_TYPE },
+
+    'data.created_at': { functionName: 'getCurrentTimeString' },
+    'data.created_by': { contextAsString: CTX_VISITOR_ID },
+    'data.created_avatar': { contextAsString: CTX_VISITOR_AVATAR },
+    'data.created_nickname': { contextAsString: CTX_VISITOR_NICKNAME },
+    'data.created_account_type': { contextAsString: CTX_VISITOR_ACCOUNT_TYPE },
+
+    'data.modified_at': { functionName: 'getCurrentTimeString' },
+    'data.modified_by': { contextAsString: CTX_VISITOR_ID },
+    'data.modified_avatar': { contextAsString: CTX_VISITOR_AVATAR },
+    'data.modified_nickname': { contextAsString: CTX_VISITOR_NICKNAME },
+    'data.modified_account_type': { contextAsString: CTX_VISITOR_ACCOUNT_TYPE },
+  };
+
+  const buildUpdateCfgBy = (cfgArray: string[], prefix: string): any => {
+    const obj: any = {};
+    if (Array.isArray(cfgArray)) {
+      for (let i = 0; i < cfgArray.length; i++) {
+        const suffix = cfgArray[i];
+        if (suffix) {
+          const key = `${prefix}_${suffix}`;
+          if (mapping[key]) {
+            obj[key] = mapping[key];
+          }
+        }
+      }
+    }
+    return obj;
+  };
+
+  // 查询语句
+  if (isSimpleQuery(sqlSimpleName)) {
+    const updateCfgObj = buildUpdateCfgBy(conditionCfgArray, 'condition.created'); // 查询用户本人创建的
+    _.merge(cfgModel.updateCfg, updateCfgObj);
+  }
+
+  // 删除语句
+  if (sqlSimpleName === KeysOfSimpleSQL.SIMPLE_DELETE) {
+    const updateCfgObj = buildUpdateCfgBy(conditionCfgArray, 'condition.created'); // 删除用户本人创建的
+    _.merge(cfgModel.updateCfg, updateCfgObj);
+  }
+
+  // 插入语句
+  if (sqlSimpleName === KeysOfSimpleSQL.SIMPLE_INSERT) {
+    const updateCfgObj1 = buildUpdateCfgBy(dataCfgArray, 'data.created');
+    _.merge(cfgModel.updateCfg, updateCfgObj1);
+
+    // 启用: 雪花ID
+    if (dataCfgArray.includes('idBySnowflakeId')) {
+      _.merge(cfgModel.updateCfg, {
+        'data.id': { functionName: 'generateSnowflakeId' },
+      });
+    }
+
+    // 启用: 扩展的雪花ID： -128bit，base58（建议数据库varchar（24））
+    if (dataCfgArray.includes('idBySnowflakeIdExt')) {
+      _.merge(cfgModel.updateCfg, {
+        'data.id': { functionName: 'generateSnowflakeIdExt' },
+      });
+    }
+
+    // 启用: UUID
+    if (dataCfgArray.includes('idByUUID')) {
+      _.merge(cfgModel.updateCfg, {
+        'data.id': { functionName: 'uuid' },
+      });
+    }
+  }
+
+  // 更新语句
+  if (sqlSimpleName === KeysOfSimpleSQL.SIMPLE_UPDATE) {
+    const updateCfgObj1 = buildUpdateCfgBy(dataCfgArray, 'data.modified');
+    const updateCfgObj2 = buildUpdateCfgBy(conditionCfgArray, 'condition.created'); // 更新用户本人创建的
+    _.merge(cfgModel.updateCfg, updateCfgObj1);
+    _.merge(cfgModel.updateCfg, updateCfgObj2);
+  }
+
+  // 插入或更新
+  if (sqlSimpleName === KeysOfSimpleSQL.SIMPLE_INSERT_OR_UPDATE || sqlSimpleName === KeysOfSimpleSQL.SIMPLE_INSERT_ON_DUPLICATE_UPDATE) {
+    const updateCfgObj1 = buildUpdateCfgBy(dataCfgArray, 'data.created');
+    const updateCfgObj2 = buildUpdateCfgBy(dataCfgArray, 'data.modified');
+    const updateCfgObj3 = buildUpdateCfgBy(conditionCfgArray, 'condition.created'); // 更新用户本人创建的
+    _.merge(cfgModel.updateCfg, updateCfgObj1);
+    _.merge(cfgModel.updateCfg, updateCfgObj2);
+    _.merge(cfgModel.updateCfg, updateCfgObj3);
+  }
+}
+
+export { fixCfgModel };

package/src/service/proxyapi/ProxyApiLoadService.ts

@@ -5,7 +5,7 @@ import { RouteTrie } from './RouteTrie';
 import { RouteHandler } from './RouteHandler';
 import { IProxyApiEntity, IUpstreamInfo } from '../../models/SystemEntities';
 import { isEntityOK, parseJsonObject } from '../../libs/utils/functions';
-import { BALANCE_STRATEGY } from './ProxyApiUtils';
+import { BALANCE_STRATEGY, normalizePathPrefix } from './ProxyApiUtils';
 import { WeightedRandom } from './WeightedRandom';
 import { WeightedRoundRobin } from './WeightedRoundRobin';
 import { bizMemCacheStore } from '@/service/base/bizmemcache/BizMemCacheStore';
@@ -74,7 +74,8 @@ export class ProxyApiLoadService extends BaseService {
     for (let i = 0; i < entities.length; i++) {
       const entity = entities[i];
       if (entity.status === 1) {
-        const path_prefix2 = '/' + entity.upstream_code + entity.path_prefix;
+        const pathPrefix = normalizePathPrefix(entity.path_prefix);
+        const path_prefix2 = '/' + entity.upstream_code + pathPrefix;
         routeTrie.addRoute(path_prefix2, new RouteHandler(entity));
       }
     }

package/src/service/proxyapi/ProxyApiUtils.ts

@@ -15,6 +15,14 @@ export const BALANCE_STRATEGY = {
  * @param str
  * @param mod
  */
+/** path_prefix 为空表示代理上游根路径；单独的 "/" 会在路由树中注册无效节点，统一归一化为空 */
+export function normalizePathPrefix(path_prefix: string | null | undefined): string {
+  if (path_prefix === '/' || path_prefix == null) {
+    return '';
+  }
+  return path_prefix;
+}
+
 export function stringHashMod(str: string, mod: number): number {
   if (!str) {
     throw new Error('stringHashMod str is required');