@cloudbase/manager-node 5.8.9-beta.0 → 5.9.0

package/lib/function/index.js

@@ -10,12 +10,14 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FunctionService = exports.ENTERPRISE_IMAGE_REGION_GUIDANCE = void 0;
+exports.formatImageDeploymentErrorMessage = formatImageDeploymentErrorMessage;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const lodash_1 = __importDefault(require("lodash"));
 const cos_nodejs_sdk_v5_1 = __importDefault(require("cos-nodejs-sdk-v5"));
 const packer_1 = require("./packer");
 const error_1 = require("../error");
+const error_types_1 = require("../error-types");
 const utils_1 = require("../utils");
 const constant_1 = require("../constant");
 /**
@@ -115,23 +117,46 @@ function getFieldIgnoreCase(obj, fieldName) {
 }
 /** 企业版 TCR 镜像对 SCF 不可见时的排查指引 */
 exports.ENTERPRISE_IMAGE_REGION_GUIDANCE = '请确认 TCR 企业版实例已在当前函数地域提供可访问的实例或复制实例，并检查 RegistryId、镜像地址及拉取权限。';
+/**
+ * 幂等缓存：错误对象 → 已增强的文本。
+ *
+ * 为什么不用「给错误对象挂标记位 / 写回 message」：
+ * 1) **不改入参** ⇒ 无副作用，不污染调用方传入的数据源；
+ * 2) 冻结 / 只读 / 不可扩展对象同样有效（此前要靠 try/catch 兜底）；
+ * 3) WeakMap 为弱引用 ⇒ 不阻碍错误对象被回收。
+ */
+const ENHANCED_MESSAGES = new WeakMap();
+/** 取出可安全取属性的错误对象（null / 原始值 ⇒ undefined） */
+function errorCarrierOf(error) {
+    return typeof error === 'object' && error !== null ? error : undefined;
+}
 /**
  * 为企业版镜像的典型不可见错误补充排查指引，同时保留原始错误和 requestId。
  * 仅匹配 SCF 已进入 enterprise 镜像查询阶段的错误，避免给普通网络或鉴权错误误导提示。
+ *
+ * 纯函数：只读入参，**不修改**传进来的错误对象；幂等由 WeakMap 缓存保证。
  */
 function formatImageDeploymentErrorMessage(error, imageConfig) {
-    const message = typeof (error === null || error === void 0 ? void 0 : error.message) === 'string' ? error.message : String(error);
-    const code = typeof (error === null || error === void 0 ? void 0 : error.code) === 'string' ? error.code : '';
+    const carrier = errorCarrierOf(error);
+    const message = typeof (carrier === null || carrier === void 0 ? void 0 : carrier.message) === 'string' ? carrier.message : String(error);
+    const code = typeof (carrier === null || carrier === void 0 ? void 0 : carrier.code) === 'string' ? carrier.code : '';
     const haystack = `${code} ${message}`.toLowerCase();
     const isEnterprise = (imageConfig === null || imageConfig === void 0 ? void 0 : imageConfig.imageType) === 'enterprise';
     const isEnterpriseImageNotFound = haystack.includes('resourcenotfound.image') ||
         haystack.includes('describe images enterprise resource not found');
-    if (!isEnterprise ||
-        !isEnterpriseImageNotFound ||
-        message.includes(exports.ENTERPRISE_IMAGE_REGION_GUIDANCE)) {
+    // 幂等只看缓存，不看文本（文本被中间层改动也不影响判定）
+    const applied = carrier ? ENHANCED_MESSAGES.get(carrier) : undefined;
+    if (applied !== undefined) {
+        return applied;
+    }
+    if (!isEnterprise || !isEnterpriseImageNotFound) {
         return message;
     }
-    return `${message}\n提示：${exports.ENTERPRISE_IMAGE_REGION_GUIDANCE}`;
+    const enhanced = `${message}\n提示：${exports.ENTERPRISE_IMAGE_REGION_GUIDANCE}`;
+    if (carrier) {
+        ENHANCED_MESSAGES.set(carrier, enhanced);
+    }
+    return enhanced;
 }
 // 解析函数配置，换成请求参数（用于 CreateFunction）
 function configToParams(options) {
@@ -267,6 +292,63 @@ function configToParams(options) {
     const runtime = params.Runtime || 'Nodejs20.19';
     return Object.assign({ Handler: func.handler || 'index.main', Runtime: 'Nodejs20.19', MemorySize: 256, InstallDependency: isNodeFunction(runtime) ? 'TRUE' : 'FALSE' }, params);
 }
+/**
+ * 判断错误是否**可重试**（AIP-194：只重试 `UNAVAILABLE` 类瞬时错误）。
+ *
+ * ⚠️ 默认**不可重试**（default-deny）：权限不足、参数非法、资源冲突等**确定性失败**立即抛出 ——
+ * 对它们重试只会浪费时间，更会把「必然失败」伪装成「偶发失败」，掩盖真实原因。
+ */
+/** 安全取字符串字段（不依赖 `as any` 断言 —— 代码评审：类型安全） */
+function pickStringField(value, key) {
+    if (typeof value !== 'object' || value === null) {
+        return '';
+    }
+    const field = value[key];
+    return typeof field === 'string' ? field : '';
+}
+/** 可重试的**精确错误码**（小写比较；AIP-194 的 UNAVAILABLE 家族 + 本层网络 errno） */
+const RETRYABLE_ERROR_CODES = new Set([
+    'resourceunavailable',
+    'serviceunavailable',
+    'internalerror',
+    'requestlimitexceeded',
+    'etimedout',
+    'econnreset',
+    'econnrefused'
+]);
+/** 仅在 ① 未命中时用于**文案**回退的瞬时信号（不含 `not found` 等语义模糊项） */
+const RETRYABLE_ERROR_TEXT_HINTS = [
+    'unavailable',
+    'internal error',
+    'timeout',
+    'connection reset',
+    'network error'
+];
+function isRetryableError(e) {
+    const code = pickStringField(e, 'code').toLowerCase();
+    const message = pickStringField(e, 'message').toLowerCase();
+    // ① 精确码优先（含 `ResourceUnavailable.xxx` 这类带子码的形态）
+    if (RETRYABLE_ERROR_CODES.has(code) || RETRYABLE_ERROR_CODES.has(code.split('.').pop() || '')) {
+        return true;
+    }
+    // ② 退一步只看瞬时信号文案
+    return RETRYABLE_ERROR_TEXT_HINTS.some(hint => message.includes(hint));
+}
+/**
+ * 判断错误是否为**创建/更新期的「资源尚不可见」**（NOT_FOUND 家族）。
+ *
+ * 场景：`CreateFunction` 已提交成功，但 `GetFunction` 短时间内仍返回 NOT_FOUND。
+ * 这类错误应**容忍并继续轮询**，而不是把正常的「创建中」误报为失败。
+ *
+ * ⚠️ 与 `isRetryableError` 分工不同：NOT_FOUND 的**竞态容忍**只在这里（轮询场景），
+ * 不进「可重试」白名单 —— 避免把「资源 ID 写错」这类确定性失败也当成可重试。
+ */
+function isNotYetVisibleError(e) {
+    const code = pickStringField(e, 'code').toLowerCase();
+    const message = pickStringField(e, 'message').toLowerCase();
+    const haystack = `${code} ${message}`;
+    return haystack.includes('notfound') || haystack.includes('not_found') || haystack.includes('not found');
+}
 class FunctionService {
     constructor(environment) {
         this.environment = environment;
@@ -307,7 +389,7 @@ class FunctionService {
             await packer.build();
             base64 = await packer.getBase64Code();
             if (!base64) {
-                throw new error_1.CloudBaseError('函数不存在！');
+                (0, error_1.throwNotFound)('函数不存在！');
             }
             params.AddFiles = base64;
         }
@@ -357,7 +439,7 @@ class FunctionService {
                 params.Code = customCode;
             }
             if (!((_c = (_b = params.Code) === null || _b === void 0 ? void 0 : _b.ImageConfig) === null || _c === void 0 ? void 0 : _c.ImageUri)) {
-                throw new error_1.CloudBaseError('镜像部署需要配置 imageConfig.imageUri');
+                (0, error_1.throwInvalidParam)('镜像部署需要配置 imageConfig.imageUri');
             }
             // 镜像函数不需要 Handler / InstallDependency
             delete params.Handler;
@@ -544,7 +626,7 @@ class FunctionService {
                 currentOffset += pageSize;
             }
             catch (error) {
-                throw new error_1.CloudBaseError(`获取函数列表失败: ${error.message}`);
+                (0, error_1.throwApiError)(`获取函数列表失败: ${error.message}`);
             }
         }
         // 格式化数据
@@ -601,7 +683,7 @@ class FunctionService {
                 (0, utils_1.successLog)(`[${name}] 函数删除成功！`);
             }
             catch (e) {
-                throw new error_1.CloudBaseError(e.message);
+                (0, error_1.throwApiError)(e.message);
             }
         })());
         await Promise.all(promises);
@@ -664,7 +746,7 @@ class FunctionService {
                 data.push(info);
             }
             catch (e) {
-                throw new error_1.CloudBaseError(`${name} 获取信息失败：${e.message}`);
+                (0, error_1.throwApiError)(`${name} 获取信息失败：${e.message}`);
             }
         })());
         await Promise.all(promises);
@@ -686,7 +768,7 @@ class FunctionService {
      * @returns {Promise<IFunctionLogRes>}
      */
     async getFunctionLogs(_options) {
-        throw new error_1.CloudBaseError('getFunctionLogs 已废弃：底层 GetFunctionLogs 接口已下线，请使用 env.getLogService().searchClsLog() 查询云函数日志');
+        (0, error_1.throwApiError)('getFunctionLogs 已废弃：底层 GetFunctionLogs 接口已下线，请使用 env.getLogService().searchClsLog() 查询云函数日志');
     }
     /**
      * 获取函数日志 ID 列表
@@ -703,7 +785,7 @@ class FunctionService {
      * @returns {Promise<IFunctionLogResV2>}
      */
     async getFunctionLogsV2(_options) {
-        throw new error_1.CloudBaseError('getFunctionLogsV2 已废弃：底层 GetFunctionLogs 接口已下线，请使用 env.getLogService().searchClsLog() 查询云函数日志');
+        (0, error_1.throwApiError)('getFunctionLogsV2 已废弃：底层 GetFunctionLogs 接口已下线，请使用 env.getLogService().searchClsLog() 查询云函数日志');
     }
     /**
      * 根据函数日志 ID 查询日志详情
@@ -716,7 +798,7 @@ class FunctionService {
      * @returns {Promise<IFunctionLogDetailRes>}
      */
     async getFunctionLogDetail(_options) {
-        throw new error_1.CloudBaseError('getFunctionLogDetail 已废弃：底层 GetFunctionLogDetail 接口已下线，请使用 env.getLogService().searchClsLog() 查询云函数日志');
+        (0, error_1.throwApiError)('getFunctionLogDetail 已废弃：底层 GetFunctionLogDetail 接口已下线，请使用 env.getLogService().searchClsLog() 查询云函数日志');
     }
     /**
      * 获取函数的完整调用日志
@@ -726,7 +808,7 @@ class FunctionService {
      * @returns {Promise<IFunctionLogDetailRes[]>} 返回包含完整日志详情的数组
      */
     async getCompleteFunctionLogs(_options) {
-        throw new error_1.CloudBaseError('getCompleteFunctionLogs 已废弃：底层 GetFunctionLogs/GetFunctionLogDetail 接口已下线，请使用 env.getLogService().searchClsLog() 查询云函数日志');
+        (0, error_1.throwApiError)('getCompleteFunctionLogs 已废弃：底层 GetFunctionLogs/GetFunctionLogDetail 接口已下线，请使用 env.getLogService().searchClsLog() 查询云函数日志');
     }
     /**
      * 更新云函数配置
@@ -885,7 +967,7 @@ class FunctionService {
                 }
             };
             if (!params.Code.ImageConfig.ImageUri) {
-                throw new error_1.CloudBaseError('镜像部署需要配置 imageConfig.imageUri');
+                (0, error_1.throwInvalidParam)('镜像部署需要配置 imageConfig.imageUri');
             }
             try {
                 // 等待函数状态正常
@@ -1023,7 +1105,7 @@ class FunctionService {
             return Object.assign({ RequestId }, Result);
         }
         catch (e) {
-            throw new error_1.CloudBaseError(`[${name}] 调用失败：${e.message}`, {
+            throw new error_1.CloudBaseError(`[${name}] 调用失败：${e.message}`, { code: 'API_ERROR', source: 'manager-node',
                 requestId: e.requestId
             });
         }
@@ -1045,7 +1127,7 @@ class FunctionService {
                 return result;
             }
             catch (e) {
-                throw new error_1.CloudBaseError(`${func.name} 函数调用失败：${e.message}`);
+                (0, error_1.throwApiError)(`${func.name} 函数调用失败：${e.message}`);
             }
         })());
         return Promise.all(promises);
@@ -1062,7 +1144,7 @@ class FunctionService {
     async copyFunction(name, newFunctionName, targetEnvId, force = false) {
         const { namespace } = this.getFunctionConfig();
         if (!namespace || !name || !newFunctionName) {
-            throw new error_1.CloudBaseError('参数缺失');
+            (0, error_1.throwInvalidParam)('参数缺失');
         }
         return this.scfService.request('CopyFunction', {
             FunctionName: name,
@@ -1084,7 +1166,7 @@ class FunctionService {
         const { namespace } = this.getFunctionConfig();
         const parsedTriggers = triggers.map(item => {
             if (item.type !== 'timer') {
-                throw new error_1.CloudBaseError(`不支持的触发器类型 [${item.type}]，目前仅支持定时触发器（timer）！`);
+                (0, error_1.throwInvalidParam)(`不支持的触发器类型 [${item.type}]，目前仅支持定时触发器（timer）！`);
             }
             return {
                 TriggerName: item.name,
@@ -1117,7 +1199,7 @@ class FunctionService {
                 (0, utils_1.successLog)(`[${func.name}] 创建云函数触发器成功！`);
             }
             catch (e) {
-                throw new error_1.CloudBaseError(e.message);
+                (0, error_1.throwApiError)(e.message);
             }
         })());
         await Promise.all(promises);
@@ -1139,7 +1221,7 @@ class FunctionService {
             });
         }
         catch (e) {
-            throw new error_1.CloudBaseError(`[${name}] 删除触发器失败：${e.message}`);
+            (0, error_1.throwApiError)(`[${name}] 删除触发器失败：${e.message}`);
         }
     }
     async batchDeleteTriggers(options) {
@@ -1150,7 +1232,7 @@ class FunctionService {
                 (0, utils_1.successLog)(`[${func.name}] 删除云函数触发器成功！`);
             }
             catch (e) {
-                throw new error_1.CloudBaseError(e.message);
+                (0, error_1.throwApiError)(e.message);
             }
         })());
         await Promise.all(promises);
@@ -1202,7 +1284,7 @@ class FunctionService {
             return { Url, RequestId, CodeSha256 };
         }
         catch (e) {
-            throw new error_1.CloudBaseError(`[${functionName}] 获取函数代码下载链接失败：${e.message}`, {
+            throw new error_1.CloudBaseError(`[${functionName}] 获取函数代码下载链接失败：${e.message}`, { code: 'API_ERROR', source: 'manager-node',
                 requestId: e.requestId
             });
         }
@@ -1231,7 +1313,7 @@ class FunctionService {
         Layers = Layers.map(item => lodash_1.default.pick(item, ['LayerName', 'LayerVersion']));
         const index = Layers.findIndex(item => item.LayerName === layerName && item.LayerVersion === layerVersion);
         if (index === -1) {
-            throw new error_1.CloudBaseError('层不存在');
+            (0, error_1.throwNotFound)('层不存在');
         }
         // 删除指定的层
         Layers.splice(index, 1);
@@ -1268,7 +1350,7 @@ class FunctionService {
         const url = res === null || res === void 0 ? void 0 : res.Location;
         const zipPath = path_1.default.join(destPath, `${name}-${version}.zip`);
         if ((0, utils_1.checkFullAccess)(zipPath)) {
-            throw new error_1.CloudBaseError(`文件已存在：${zipPath}`);
+            (0, error_1.throwInvalidParam)(`文件已存在：${zipPath}`);
         }
         // 下载文件
         return (0, utils_1.downloadAndExtractRemoteZip)(url, destPath);
@@ -1301,7 +1383,7 @@ class FunctionService {
         else {
             const fileType = path_1.default.extname(contentPath);
             if (fileType !== '.zip') {
-                throw new error_1.CloudBaseError('文件类型不正确，目前只支持 ZIP 文件！');
+                (0, error_1.throwInvalidParam)('文件类型不正确，目前只支持 ZIP 文件！');
             }
             const fileBuffer = await fs_1.default.promises.readFile(contentPath);
             base64 = fileBuffer.toString('base64');
@@ -1370,7 +1452,9 @@ class FunctionService {
             timer = setTimeout(() => {
                 clearInterval(ticker);
                 if (!resolved) {
-                    reject(new error_1.CloudBaseError('函数状态异常，检查超时'));
+                    // ⚠️ 不能写 reject(throwNetError(...))：该 helper 必抛 ⇒ 异常抛在定时器回调里、
+                    // Promise 永不 settle ⇒ 调用方挂死。**值位置**必须构造错误对象。
+                    reject(new error_1.CloudBaseError('函数状态异常，检查超时', { type: error_types_1.ERROR_TYPES.netError }));
                 }
             }, 300000);
             ticker = setInterval(async () => {
@@ -1384,7 +1468,7 @@ class FunctionService {
                         const errorDetails = (StatusReasons === null || StatusReasons === void 0 ? void 0 : StatusReasons.map(item => `[${item.ErrorCode}] ${item.ErrorMessage}`).join('\n')) || '';
                         const errorMsg = `云函数创建失败${StatusDesc ? `\n状态描述: ${StatusDesc}` : ''}${errorDetails ? `\n失败信息: ${errorDetails}` : ''}`;
                         // 注意：这里不传递 RequestId，因为这是 GetFunction 的 RequestId，不是导致失败的 CreateFunction/UpdateFunctionCode 的 RequestId
-                        throw new error_1.CloudBaseError(errorMsg);
+                        (0, error_1.throwApiError)(errorMsg);
                     }
                     // 函数状态正常
                     clearInterval(ticker);
@@ -1392,6 +1476,10 @@ class FunctionService {
                     resolve();
                 }
                 catch (e) {
+                    // 容忍创建/更新期的「资源尚不可见」：`GetFunction` 在函数刚提交后会短暂返回 NOT_FOUND，
+                    // 此时继续轮询即可（超时仍由 5 分钟定时器兜底）—— 否则会把正常的「创建中」误报为失败。
+                    if (isNotYetVisibleError(e))
+                        return;
                     clearInterval(ticker);
                     clearTimeout(timer);
                     reject(e);
@@ -1523,7 +1611,7 @@ class FunctionService {
         const { func, functionPath, functionRootPath } = options;
         const { env, appId } = this.getFunctionConfig();
         if (!appId) {
-            throw new error_1.CloudBaseError('无法获取 AppId，请确认环境初始化完成或已开通存储服务');
+            (0, error_1.throwApiError)('无法获取 AppId，请确认环境初始化完成或已开通存储服务');
         }
         const objectPath = `${appId}/${env}/${func.name}.zip`;
         // 1. 生成存放函数包的临时 Cos 目录
@@ -1565,7 +1653,8 @@ class FunctionService {
             // 添加超时保护
             const timeout = setTimeout(() => {
                 packer.clean();
-                reject(new error_1.CloudBaseError(`[${func.name}] COS 上传超时（60秒）`));
+                // 同上：值位置不能调用必抛 helper
+                reject(new error_1.CloudBaseError(`[${func.name}] COS 上传超时（60秒）`, { type: error_types_1.ERROR_TYPES.netError }));
             }, 60000);
             cos.sliceUploadFile(uploadParams, async (err, data) => {
                 clearTimeout(timeout);
@@ -1640,7 +1729,7 @@ class FunctionService {
             catch (e) {
                 // 忽略响应体解析错误
             }
-            throw new error_1.CloudBaseError(`上传失败: ${response.status} ${response.statusText}${errorDetail}`);
+            (0, error_1.throwApiError)(`上传失败: ${response.status} ${response.statusText}${errorDetail}`);
         }
         // 清理临时文件
         await packer.clean();
@@ -1655,7 +1744,7 @@ class FunctionService {
         const MAX_ZIP_SIZE = 1.5 * 1024 * 1024; // 1.5MB
         const MAX_BASE64_LENGTH = Math.floor((MAX_ZIP_SIZE * 4) / 3); // ≈ 2097152
         if ((base64Code === null || base64Code === void 0 ? void 0 : base64Code.length) > MAX_BASE64_LENGTH) {
-            throw new error_1.CloudBaseError('ZipFile 上传不能大于 1.5MB，请使用 COS 上传方式');
+            (0, error_1.throwInvalidParam)('ZipFile 上传不能大于 1.5MB，请使用 COS 上传方式');
         }
         if (base64Code === null || base64Code === void 0 ? void 0 : base64Code.length) {
             return {
@@ -1680,11 +1769,11 @@ class FunctionService {
             // 判断是否超过 ZipFile 上传大小限制（1.5MB）
             const reachMax = await packer.isReachMaxSize();
             if (reachMax) {
-                throw new error_1.CloudBaseError('ZipFile 上传不能大于 1.5MB，请使用 COS 上传方式（deployMode: "cos"）');
+                (0, error_1.throwInvalidParam)('ZipFile 上传不能大于 1.5MB，请使用 COS 上传方式（deployMode: "cos"）');
             }
             const base64 = await packer.getBase64Code();
             if (!(base64 === null || base64 === void 0 ? void 0 : base64.length)) {
-                throw new error_1.CloudBaseError('文件不能为空');
+                (0, error_1.throwInvalidParam)('文件不能为空');
             }
             console.log(`[${func.name}] 部署方式: ZIP base64 上传`);
             return {
@@ -1736,20 +1825,25 @@ class FunctionService {
             ObjectPath: `${appId}/${env}/${name}.zip"`
         });
     }
+    /**
+     * 创建触发器（带重试）。
+     *
+     * ⚠️ AIP-194：**只重试可重试错误**。旧实现是 catch-all 盲重试 —— 权限不足 / 参数非法这类
+     * **必然失败**的错误也会被重试 3 次，既浪费时间，又把确定性失败伪装成偶发失败、掩盖真实原因。
+     */
     async retryCreateTrigger(name, triggers, count = 0) {
         try {
             const res = await this.createFunctionTriggers(name, triggers);
             return res;
         }
         catch (e) {
-            if (count < 3) {
-                await (0, utils_1.sleep)(500);
-                const res = await this.retryCreateTrigger(name, triggers, count + 1);
-                return res;
-            }
-            else {
+            // 不可重试（权限 / 参数 / 资源冲突等）或已达上限 → 立即抛出真实错误
+            if (!isRetryableError(e) || count >= 3) {
                 throw e;
             }
+            console.warn(`[${name}] 创建触发器遇到可重试错误（第 ${count + 1}/3 次），500ms 后重试：${pickStringField(e, 'message') || String(e)}`);
+            await (0, utils_1.sleep)(500);
+            return this.retryCreateTrigger(name, triggers, count + 1);
         }
     }
     /**

package/lib/function/packer.js

@@ -100,7 +100,7 @@ class FunctionPacker {
         const jarExist = (0, utils_1.checkFullAccess)(`${filePath}.jar`);
         const zipExist = (0, utils_1.checkFullAccess)(`${filePath}.zip`);
         if (!jarExist && !zipExist) {
-            throw new error_1.CloudBaseError('未找到部署函数的 Jar 或者 ZIP 格式文件！');
+            (0, error_1.throwNotFound)('未找到部署函数的 Jar 或者 ZIP 格式文件！');
         }
         this.zipFilePath = jarExist ? `${filePath}.jar` : `${filePath}.zip`;
     }

package/lib/hosting/index.js

@@ -54,7 +54,7 @@ class HostingService {
             const website = hostings[0];
             // offline 状态的服务可重新开启
             if (website.Status !== 'offline') {
-                throw new error_1.CloudBaseError('静态网站服务已开启，请勿重复操作！');
+                (0, error_1.throwApiError)('静态网站服务已开启，请勿重复操作！');
             }
         }
         const res = await this.tcbService.request('CreateStaticStore', {

package/lib/index.js

@@ -1,4 +1,5 @@
 "use strict";
+const error_1 = require("./error");
 const context_1 = require("./context");
 const environmentManager_1 = require("./environmentManager");
 const docs_1 = require("./docs");
@@ -25,7 +26,7 @@ class CloudBase {
         let { secretId, secretKey, token, envId, proxy, region, envType, useInternalEndpoint, internalEndpointRegion, requestFn } = config;
         // config 中传入的 secretId secretkey 必须同时存在（有 requestFn 时可以不传）
         if (!requestFn && ((secretId && !secretKey) || (!secretId && secretKey))) {
-            throw new Error('secretId and secretKey must be a pair');
+            (0, error_1.throwInvalidParam)('secretId and secretKey must be a pair');
         }
         this.cloudBaseConfig = {
             secretId: secretId ? secretId.trim() : secretId,

package/lib/integration/crypto.js

@@ -49,6 +49,7 @@ exports.aesEncryptWithIv = aesEncryptWithIv;
  * 使用 Node 内置 crypto 复刻，无需引入额外依赖。
  */
 const crypto = __importStar(require("crypto"));
+const error_1 = require("../error");
 const ALGORITHM = 'aes-256-cbc';
 const KEY_BYTE_LENGTH = 32;
 const IV_BYTE_LENGTH = 16;
@@ -56,7 +57,7 @@ const IV_BYTE_LENGTH = 16;
 const IV_BASE64_LENGTH = 24;
 function assertKey(key) {
     if (Buffer.byteLength(key, 'utf8') !== KEY_BYTE_LENGTH) {
-        throw new Error('AES key 必须是 32 字节长度');
+        (0, error_1.throwInvalidParam)('AES key 必须是 32 字节长度');
     }
 }
 /**
@@ -65,7 +66,7 @@ function assertKey(key) {
 function aesEncryptWithIv(plaintext, key, iv) {
     assertKey(key);
     if (iv.length !== IV_BYTE_LENGTH) {
-        throw new Error('IV 必须是 16 字节长度');
+        (0, error_1.throwInvalidParam)('IV 必须是 16 字节长度');
     }
     const cipher = crypto.createCipheriv(ALGORITHM, Buffer.from(key, 'utf8'), iv);
     const encrypted = Buffer.concat([cipher.update(plaintext, 'utf8'), cipher.final()]);
@@ -89,7 +90,7 @@ class AESCryptoImpl {
         const ciphertextBase64 = encryptedData.slice(IV_BASE64_LENGTH);
         const iv = Buffer.from(ivBase64, 'base64');
         if (iv.length !== IV_BYTE_LENGTH) {
-            throw new Error('密文格式错误：IV 长度非法');
+            (0, error_1.throwInvalidParam)('密文格式错误：IV 长度非法');
         }
         const decipher = crypto.createDecipheriv(ALGORITHM, Buffer.from(key, 'utf8'), iv);
         const decrypted = Buffer.concat([

package/lib/integration/index.js

@@ -170,7 +170,7 @@ class IntegrationService {
     validateRequiredParams(params, fields) {
         for (const field of fields) {
             if (!params[field]) {
-                throw new error_1.CloudBaseError(`${field} 是必填参数`);
+                (0, error_1.throwInvalidParam)(`${field} 是必填参数`);
             }
         }
     }

package/lib/integration/secretKey.js

@@ -60,24 +60,24 @@ async function getAesKey(params = {}) {
         });
     }
     catch (e) {
-        throw new error_1.CloudBaseError('获取集成加解密密钥失败：七彩石配置拉取请求异常');
+        (0, error_1.throwApiError)('获取集成加解密密钥失败：七彩石配置拉取请求异常');
     }
     const data = (_a = resJson === null || resJson === void 0 ? void 0 : resJson.Response) === null || _a === void 0 ? void 0 : _a.Data;
     if (!data || data.ErrorCode !== '0') {
-        throw new error_1.CloudBaseError(`获取集成加解密密钥失败：七彩石返回异常（ErrorCode=${data === null || data === void 0 ? void 0 : data.ErrorCode}）`);
+        (0, error_1.throwApiError)(`获取集成加解密密钥失败：七彩石返回异常（ErrorCode=${data === null || data === void 0 ? void 0 : data.ErrorCode}）`);
     }
     let config;
     try {
         config = JSON.parse(data.ConfigValue)[0];
     }
     catch (e) {
-        throw new error_1.CloudBaseError('获取集成加解密密钥失败：七彩石配置内容解析失败');
+        (0, error_1.throwApiError)('获取集成加解密密钥失败：七彩石配置内容解析失败');
     }
     const kvs = ((_b = config === null || config === void 0 ? void 0 : config.kvs) === null || _b === void 0 ? void 0 : _b.kvs) || [];
     const target = kvs.find(kv => kv.key === RAINBOW_CONFIG.CRYPTO_KEY_FIELD);
     const key = target === null || target === void 0 ? void 0 : target.value;
     if (!key) {
-        throw new error_1.CloudBaseError(`获取集成加解密密钥失败：七彩石配置中缺少 ${RAINBOW_CONFIG.CRYPTO_KEY_FIELD} 字段`);
+        (0, error_1.throwApiError)(`获取集成加解密密钥失败：七彩石配置中缺少 ${RAINBOW_CONFIG.CRYPTO_KEY_FIELD} 字段`);
     }
     keyCache[group] = key;
     return key;

package/lib/monitor/index.js

@@ -37,7 +37,7 @@ function validatePeriod(startStr, endStr, period) {
     const rangeMs = endMs - startMs;
     const rule = PERIOD_RULES.find(r => rangeMs <= r.maxRangeMs);
     if (rule && !rule.allowed.includes(period)) {
-        throw new error_1.CloudBaseError(`Period=${period} 不适用于当前时间范围。` +
+        (0, error_1.throwInvalidParam)(`Period=${period} 不适用于当前时间范围。` +
             `时间范围 ${startStr} ~ ${endStr}（约 ${(rangeMs / ONE_DAY_MS).toFixed(1)} 天）` +
             `仅支持 Period: [${rule.allowed.join(', ')}]`);
     }

package/lib/mysql/index.js

@@ -22,6 +22,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MysqlService = void 0;
 const utils_1 = require("../utils");
+const error_1 = require("../error");
 __exportStar(require("./types/index"), exports);
 class MysqlService {
     constructor(environment) {
@@ -416,7 +417,7 @@ class MysqlService {
             const res = await this.describeClusterInstanceGroups();
             const groups = res.InstanceGroupInfoList;
             if (!groups || groups.length === 0) {
-                throw new Error('当前集群没有实例组，无法执行外网操作');
+                (0, error_1.throwApiError)('当前集群没有实例组，无法执行外网操作');
             }
             this._instanceGroupId = groups[0].InstanceGroupId;
         }