befly 3.15.2 → 3.15.4

package/dist/befly.config.js

@@ -12,6 +12,7 @@ const defaultOptions = {
     devPassword: "beflydev123456",
     bodyLimit: 1048576, // 1MB
     tz: "Asia/Shanghai",
+    strict: true,
     // ========== 日志配置 ==========
     logger: {
         debug: 1,
@@ -24,6 +25,7 @@ const defaultOptions = {
     },
     // ========== 数据库配置 ==========
     db: {
+        idMode: "timeId",
         host: "127.0.0.1",
         port: 3306,
         username: "root",
@@ -93,5 +95,17 @@ export async function loadBeflyConfig(nodeEnv) {
             throw new Error(`配置错误：redis.prefix 不允许包含 ':'（RedisHelper 会自动拼接分隔符 ':'），请改为不带冒号的前缀，例如 'befly_demo'，当前值=${redisPrefix}`);
         }
     }
+    const idMode = config.db?.idMode;
+    if (idMode !== undefined && idMode !== "timeId" && idMode !== "autoId") {
+        throw new Error(`配置错误：db.idMode 只能是 'timeId' 或 'autoId'，当前值=${String(idMode)}`);
+    }
+    const strict = config.strict;
+    if (strict !== undefined && typeof strict !== "boolean") {
+        throw new Error(`配置错误：strict 必须为 boolean，当前值=${String(strict)}`);
+    }
+    const legacyCheckTable = config.checkTable;
+    if (legacyCheckTable !== undefined) {
+        throw new Error(`配置错误：checkTable 配置已废弃，请使用根属性 strict（例如 { "strict": false }），当前值=${String(legacyCheckTable)}`);
+    }
     return config;
 }

package/dist/befly.js

@@ -7537,6 +7537,7 @@ var defaultOptions = {
   devPassword: "beflydev123456",
   bodyLimit: 1048576,
   tz: "Asia/Shanghai",
+  strict: true,
   logger: {
     debug: 1,
     excludeFields: ["password", "token", "secret"],
@@ -7547,6 +7548,7 @@ var defaultOptions = {
     maxArrayItems: 100
   },
   db: {
+    idMode: "timeId",
     host: "127.0.0.1",
     port: 3306,
     username: "root",
@@ -7602,6 +7604,18 @@ async function loadBeflyConfig(nodeEnv) {
       throw new Error(`\u914D\u7F6E\u9519\u8BEF\uFF1Aredis.prefix \u4E0D\u5141\u8BB8\u5305\u542B ':'\uFF08RedisHelper \u4F1A\u81EA\u52A8\u62FC\u63A5\u5206\u9694\u7B26 ':'\uFF09\uFF0C\u8BF7\u6539\u4E3A\u4E0D\u5E26\u5192\u53F7\u7684\u524D\u7F00\uFF0C\u4F8B\u5982 'befly_demo'\uFF0C\u5F53\u524D\u503C=${redisPrefix}`);
     }
   }
+  const idMode = config2.db?.idMode;
+  if (idMode !== undefined && idMode !== "timeId" && idMode !== "autoId") {
+    throw new Error(`\u914D\u7F6E\u9519\u8BEF\uFF1Adb.idMode \u53EA\u80FD\u662F 'timeId' \u6216 'autoId'\uFF0C\u5F53\u524D\u503C=${String(idMode)}`);
+  }
+  const strict = config2.strict;
+  if (strict !== undefined && typeof strict !== "boolean") {
+    throw new Error(`\u914D\u7F6E\u9519\u8BEF\uFF1Astrict \u5FC5\u987B\u4E3A boolean\uFF0C\u5F53\u524D\u503C=${String(strict)}`);
+  }
+  const legacyCheckTable = config2.checkTable;
+  if (legacyCheckTable !== undefined) {
+    throw new Error(`\u914D\u7F6E\u9519\u8BEF\uFF1AcheckTable \u914D\u7F6E\u5DF2\u5E9F\u5F03\uFF0C\u8BF7\u4F7F\u7528\u6839\u5C5E\u6027 strict\uFF08\u4F8B\u5982 { "strict": false }\uFF09\uFF0C\u5F53\u524D\u503C=${String(legacyCheckTable)}`);
+  }
   return config2;
 }
 
@@ -7725,6 +7739,19 @@ function isValidPort(value) {
 function isValidNonNegativeInt(value) {
   return typeof value === "number" && Number.isFinite(value) && value >= 0 && Math.floor(value) === value;
 }
+function isValidPositiveInt(value) {
+  return typeof value === "number" && Number.isFinite(value) && value >= 1 && Math.floor(value) === value;
+}
+function isValidTimeZone(value) {
+  if (!isNonEmptyString(value))
+    return false;
+  try {
+    new Intl.DateTimeFormat("en-US", { timeZone: value }).format(0);
+    return true;
+  } catch {
+    return false;
+  }
+}
 function validateDbConfig(db) {
   if (!db) {
     throw new Error("\u914D\u7F6E\u9519\u8BEF\uFF1A\u7F3A\u5C11 db \u914D\u7F6E\uFF08config.db\uFF09");
@@ -7780,6 +7807,11 @@ async function checkConfig(config2) {
   if (config2.nodeEnv !== "development" && config2.nodeEnv !== "production") {
     throw new Error(`\u914D\u7F6E\u9519\u8BEF\uFF1AnodeEnv \u53EA\u80FD\u662F development/production\uFF0C\u5F53\u524D\u503C=${String(config2.nodeEnv)}`);
   }
+  if (config2.appName !== undefined) {
+    if (!isNonEmptyString(config2.appName)) {
+      throw new Error(`\u914D\u7F6E\u9519\u8BEF\uFF1AappName \u5FC5\u987B\u4E3A\u975E\u7A7A\u5B57\u7B26\u4E32\uFF0C\u5F53\u524D\u503C=${String(config2.appName)}`);
+    }
+  }
   if (config2.appPort !== undefined) {
     if (!isValidPort(config2.appPort)) {
       throw new Error(`\u914D\u7F6E\u9519\u8BEF\uFF1AappPort \u5FC5\u987B\u4E3A 1..65535 \u7684\u6570\u5B57\uFF0C\u5F53\u524D\u503C=${String(config2.appPort)}`);
@@ -7790,6 +7822,33 @@ async function checkConfig(config2) {
       throw new Error(`\u914D\u7F6E\u9519\u8BEF\uFF1AappHost \u5FC5\u987B\u4E3A\u975E\u7A7A\u5B57\u7B26\u4E32\uFF0C\u5F53\u524D\u503C=${String(config2.appHost)}`);
     }
   }
+  if (config2.devEmail !== undefined) {
+    if (typeof config2.devEmail !== "string") {
+      throw new Error(`\u914D\u7F6E\u9519\u8BEF\uFF1AdevEmail \u5FC5\u987B\u4E3A\u5B57\u7B26\u4E32\uFF08\u5141\u8BB8\u4E3A\u7A7A\u5B57\u7B26\u4E32\uFF09\uFF0C\u5F53\u524D\u503C=${String(config2.devEmail)}`);
+    }
+    const trimmedDevEmail = config2.devEmail.trim();
+    if (trimmedDevEmail.length > 0 && !trimmedDevEmail.includes("@")) {
+      throw new Error(`\u914D\u7F6E\u9519\u8BEF\uFF1AdevEmail \u683C\u5F0F\u9519\u8BEF\uFF08\u5FC5\u987B\u5305\u542B '@'\uFF0C\u6216\u7F6E\u4E3A\u7A7A\u5B57\u7B26\u4E32\u4EE5\u7981\u7528 syncDev\uFF09\uFF0C\u5F53\u524D\u503C=${String(config2.devEmail)}`);
+    }
+  }
+  if (config2.devPassword !== undefined) {
+    if (typeof config2.devPassword !== "string") {
+      throw new Error(`\u914D\u7F6E\u9519\u8BEF\uFF1AdevPassword \u5FC5\u987B\u4E3A\u5B57\u7B26\u4E32\uFF08\u5141\u8BB8\u4E3A\u7A7A\u5B57\u7B26\u4E32\uFF09\uFF0C\u5F53\u524D\u503C=${String(config2.devPassword)}`);
+    }
+  }
+  if (config2.bodyLimit !== undefined) {
+    if (!isValidPositiveInt(config2.bodyLimit)) {
+      throw new Error(`\u914D\u7F6E\u9519\u8BEF\uFF1AbodyLimit \u5FC5\u987B\u4E3A\u6B63\u6574\u6570\uFF08\u5B57\u8282\uFF09\uFF0C\u5F53\u524D\u503C=${String(config2.bodyLimit)}`);
+    }
+  }
+  if (config2.tz !== undefined) {
+    if (!isValidTimeZone(config2.tz)) {
+      throw new Error(`\u914D\u7F6E\u9519\u8BEF\uFF1Atz \u5FC5\u987B\u4E3A\u6709\u6548\u7684 IANA \u65F6\u533A\u5B57\u7B26\u4E32\uFF08\u4F8B\u5982 'Asia/Shanghai'\uFF09\uFF0C\u5F53\u524D\u503C=${String(config2.tz)}`);
+    }
+  }
+  if (typeof config2.strict !== "boolean") {
+    throw new Error(`\u914D\u7F6E\u9519\u8BEF\uFF1Astrict \u5FC5\u987B\u4E3A true \u6216 false\uFF0C\u5F53\u524D\u503C=${String(config2.strict)}`);
+  }
   validateDbConfig(config2.db);
   validateRedisConfig(config2.redis);
 }
@@ -8196,7 +8255,7 @@ var FIELD_NAME_REGEX = /^[\u4e00-\u9fa5a-zA-Z0-9 _-]+$/;
 var MAX_VARCHAR_LENGTH = 16383;
 var MAX_INDEX_STRING_LENGTH_FOR_INDEX = 500;
 var MAX_INDEX_STRING_LENGTH_FOR_UNIQUE = 180;
-async function checkTable(tables) {
+async function checkTable(tables, config2) {
   let hasError = false;
   for (const item of tables) {
     if (item.type !== "table") {
@@ -8285,87 +8344,88 @@ async function checkTable(tables) {
           Logger.warn(`${tablePrefix}${fileName} \u6587\u4EF6 ${colKey} \u5B57\u6BB5 default \u7C7B\u578B\u9519\u8BEF\uFF0C\u5FC5\u987B\u4E3A\u53EF JSON \u5E8F\u5217\u5316\u7684\u503C\u6216 null` + `\uFF08typeof=${typeof field.default}\uFF0Cvalue=${formatValuePreview(field.default)}\uFF09`);
           hasError = true;
         }
-        const { name: fieldName, type: fieldType, min: fieldMin, max: fieldMax, default: fieldDefault } = field;
-        if (!FIELD_NAME_REGEX.test(fieldName)) {
-          Logger.warn(`${tablePrefix}${fileName} \u6587\u4EF6 ${colKey} \u5B57\u6BB5\u540D\u79F0 "${fieldName}" \u683C\u5F0F\u9519\u8BEF\uFF0C` + `\u5FC5\u987B\u4E3A\u4E2D\u6587\u3001\u6570\u5B57\u3001\u5B57\u6BCD\u3001\u4E0B\u5212\u7EBF\u3001\u77ED\u6A2A\u7EBF\u3001\u7A7A\u683C`);
-          hasError = true;
+        if (config2.strict) {
+          if (!FIELD_NAME_REGEX.test(field.name)) {
+            Logger.warn(`${tablePrefix}${fileName} \u6587\u4EF6 ${colKey} \u5B57\u6BB5\u540D\u79F0 "${field.name}" \u683C\u5F0F\u9519\u8BEF\uFF0C` + `\u5FC5\u987B\u4E3A\u4E2D\u6587\u3001\u6570\u5B57\u3001\u5B57\u6BCD\u3001\u4E0B\u5212\u7EBF\u3001\u77ED\u6A2A\u7EBF\u3001\u7A7A\u683C`);
+            hasError = true;
+          }
         }
-        if (!FIELD_TYPE_SET.has(fieldType)) {
-          Logger.warn(`${tablePrefix}${fileName} \u6587\u4EF6 ${colKey} \u5B57\u6BB5\u7C7B\u578B "${fieldType}" \u683C\u5F0F\u9519\u8BEF\uFF0C` + `\u5FC5\u987B\u4E3A${FIELD_TYPES.join("\u3001")}\u4E4B\u4E00`);
+        if (!FIELD_TYPE_SET.has(field.type)) {
+          Logger.warn(`${tablePrefix}${fileName} \u6587\u4EF6 ${colKey} \u5B57\u6BB5\u7C7B\u578B "${field.type}" \u683C\u5F0F\u9519\u8BEF\uFF0C` + `\u5FC5\u987B\u4E3A${FIELD_TYPES.join("\u3001")}\u4E4B\u4E00`);
           hasError = true;
         }
-        if (fieldType !== "number" && field.unsigned !== undefined) {
-          Logger.warn(`${tablePrefix}${fileName} \u6587\u4EF6 ${colKey} \u5B57\u6BB5\u7C7B\u578B\u4E3A ${fieldType}\uFF0C\u4E0D\u5141\u8BB8\u8BBE\u7F6E unsigned\uFF08\u4EC5 number \u7C7B\u578B\u6709\u6548\uFF09`);
+        if (field.type !== "number" && field.unsigned !== undefined) {
+          Logger.warn(`${tablePrefix}${fileName} \u6587\u4EF6 ${colKey} \u5B57\u6BB5\u7C7B\u578B\u4E3A ${field.type}\uFF0C\u4E0D\u5141\u8BB8\u8BBE\u7F6E unsigned\uFF08\u4EC5 number \u7C7B\u578B\u6709\u6548\uFF09`);
           hasError = true;
         }
         if (field.unique === true && field.index === true) {
           Logger.warn(`${tablePrefix}${fileName} \u6587\u4EF6 ${colKey} \u540C\u65F6\u8BBE\u7F6E\u4E86 unique=true \u548C index=true\uFF0C` + `unique \u548C index \u4E0D\u80FD\u540C\u65F6\u8BBE\u7F6E\uFF0C\u8BF7\u5220\u9664\u5176\u4E00\uFF08\u5426\u5219\u4F1A\u521B\u5EFA\u91CD\u590D\u7D22\u5F15\uFF09`);
           hasError = true;
         }
-        if (fieldMin !== undefined && fieldMax !== undefined && fieldMin !== null && fieldMax !== null) {
-          if (fieldMin > fieldMax) {
-            Logger.warn(`${tablePrefix}${fileName} \u6587\u4EF6 ${colKey} \u6700\u5C0F\u503C "${fieldMin}" \u4E0D\u80FD\u5927\u4E8E\u6700\u5927\u503C "${fieldMax}"`);
+        if (field.min !== undefined && field.max !== undefined && field.min !== null && field.max !== null) {
+          if (field.min > field.max) {
+            Logger.warn(`${tablePrefix}${fileName} \u6587\u4EF6 ${colKey} \u6700\u5C0F\u503C "${field.min}" \u4E0D\u80FD\u5927\u4E8E\u6700\u5927\u503C "${field.max}"`);
             hasError = true;
           }
         }
-        if (fieldType === "text" || fieldType === "array_text" || fieldType === "array_number_text") {
-          if (fieldMin !== undefined && fieldMin !== null) {
-            Logger.warn(`${tablePrefix}${fileName} \u6587\u4EF6 ${colKey} \u7684 ${fieldType} \u7C7B\u578B\u6700\u5C0F\u503C\u5E94\u4E3A null\uFF0C\u5F53\u524D\u4E3A "${fieldMin}"`);
+        if (field.type === "text" || field.type === "array_text" || field.type === "array_number_text") {
+          if (field.min !== undefined && field.min !== null) {
+            Logger.warn(`${tablePrefix}${fileName} \u6587\u4EF6 ${colKey} \u7684 ${field.type} \u7C7B\u578B\u6700\u5C0F\u503C\u5E94\u4E3A null\uFF0C\u5F53\u524D\u4E3A "${field.min}"`);
             hasError = true;
           }
-          if (fieldMax !== undefined && fieldMax !== null) {
-            Logger.warn(`${tablePrefix}${fileName} \u6587\u4EF6 ${colKey} \u7684 ${fieldType} \u7C7B\u578B\u6700\u5927\u957F\u5EA6\u5E94\u4E3A null\uFF0C\u5F53\u524D\u4E3A "${fieldMax}"`);
+          if (field.max !== undefined && field.max !== null) {
+            Logger.warn(`${tablePrefix}${fileName} \u6587\u4EF6 ${colKey} \u7684 ${field.type} \u7C7B\u578B\u6700\u5927\u957F\u5EA6\u5E94\u4E3A null\uFF0C\u5F53\u524D\u4E3A "${field.max}"`);
             hasError = true;
           }
-          if (fieldDefault !== undefined && fieldDefault !== null) {
-            Logger.warn(`${tablePrefix}${fileName} \u6587\u4EF6 ${colKey} \u4E3A ${fieldType} \u7C7B\u578B\uFF0C\u9ED8\u8BA4\u503C\u5FC5\u987B\u4E3A null\uFF0C\u5F53\u524D\u4E3A "${fieldDefault}"`);
+          if (field.default !== undefined && field.default !== null) {
+            Logger.warn(`${tablePrefix}${fileName} \u6587\u4EF6 ${colKey} \u4E3A ${field.type} \u7C7B\u578B\uFF0C\u9ED8\u8BA4\u503C\u5FC5\u987B\u4E3A null\uFF0C\u5F53\u524D\u4E3A "${field.default}"`);
             hasError = true;
           }
           if (field.index === true) {
-            Logger.warn(`${tablePrefix}${fileName} \u6587\u4EF6 ${colKey} \u4E3A ${fieldType} \u7C7B\u578B\uFF0C\u4E0D\u652F\u6301\u521B\u5EFA\u7D22\u5F15\uFF08index=true \u65E0\u6548\uFF09`);
+            Logger.warn(`${tablePrefix}${fileName} \u6587\u4EF6 ${colKey} \u4E3A ${field.type} \u7C7B\u578B\uFF0C\u4E0D\u652F\u6301\u521B\u5EFA\u7D22\u5F15\uFF08index=true \u65E0\u6548\uFF09`);
             hasError = true;
           }
           if (field.unique === true) {
-            Logger.warn(`${tablePrefix}${fileName} \u6587\u4EF6 ${colKey} \u4E3A ${fieldType} \u7C7B\u578B\uFF0C\u4E0D\u652F\u6301\u552F\u4E00\u7EA6\u675F\uFF08unique=true \u65E0\u6548\uFF09`);
+            Logger.warn(`${tablePrefix}${fileName} \u6587\u4EF6 ${colKey} \u4E3A ${field.type} \u7C7B\u578B\uFF0C\u4E0D\u652F\u6301\u552F\u4E00\u7EA6\u675F\uFF08unique=true \u65E0\u6548\uFF09`);
             hasError = true;
           }
-        } else if (fieldType === "string" || fieldType === "array_string" || fieldType === "array_number_string") {
-          if (fieldMax === undefined || fieldMax === null || typeof fieldMax !== "number") {
-            Logger.warn(`${tablePrefix}${fileName} \u6587\u4EF6 ${colKey} \u4E3A ${fieldType} \u7C7B\u578B\uFF0C` + `\u5FC5\u987B\u8BBE\u7F6E max \u4E14\u7C7B\u578B\u4E3A\u6570\u5B57\uFF1B\u5176\u4E2D array_*_string \u7684 max \u8868\u793A\u5355\u4E2A\u5143\u7D20\u957F\u5EA6\uFF0C\u5F53\u524D\u4E3A "${fieldMax}"`);
+        } else if (field.type === "string" || field.type === "array_string" || field.type === "array_number_string") {
+          if (field.max === undefined || field.max === null || typeof field.max !== "number") {
+            Logger.warn(`${tablePrefix}${fileName} \u6587\u4EF6 ${colKey} \u4E3A ${field.type} \u7C7B\u578B\uFF0C` + `\u5FC5\u987B\u8BBE\u7F6E max \u4E14\u7C7B\u578B\u4E3A\u6570\u5B57\uFF1B\u5176\u4E2D array_*_string \u7684 max \u8868\u793A\u5355\u4E2A\u5143\u7D20\u957F\u5EA6\uFF0C\u5F53\u524D\u4E3A "${field.max}"`);
             hasError = true;
-          } else if (fieldMax > MAX_VARCHAR_LENGTH) {
-            Logger.warn(`${tablePrefix}${fileName} \u6587\u4EF6 ${colKey} \u6700\u5927\u957F\u5EA6 ${fieldMax} \u8D8A\u754C\uFF0C` + `${fieldType} \u7C7B\u578B\u957F\u5EA6\u5FC5\u987B\u5728 1..${MAX_VARCHAR_LENGTH} \u8303\u56F4\u5185`);
+          } else if (field.max > MAX_VARCHAR_LENGTH) {
+            Logger.warn(`${tablePrefix}${fileName} \u6587\u4EF6 ${colKey} \u6700\u5927\u957F\u5EA6 ${field.max} \u8D8A\u754C\uFF0C` + `${field.type} \u7C7B\u578B\u957F\u5EA6\u5FC5\u987B\u5728 1..${MAX_VARCHAR_LENGTH} \u8303\u56F4\u5185`);
             hasError = true;
           } else {
-            if (field.index === true && fieldMax > MAX_INDEX_STRING_LENGTH_FOR_INDEX) {
-              Logger.warn(`${tablePrefix}${fileName} \u6587\u4EF6 ${colKey} \u8BBE\u7F6E\u4E86 index=true\uFF0C` + `\u4F46 max=${fieldMax} \u8D85\u51FA\u5141\u8BB8\u8303\u56F4\uFF08\u8981\u6C42 <= ${MAX_INDEX_STRING_LENGTH_FOR_INDEX}\uFF09`);
+            if (field.index === true && field.max > MAX_INDEX_STRING_LENGTH_FOR_INDEX) {
+              Logger.warn(`${tablePrefix}${fileName} \u6587\u4EF6 ${colKey} \u8BBE\u7F6E\u4E86 index=true\uFF0C` + `\u4F46 max=${field.max} \u8D85\u51FA\u5141\u8BB8\u8303\u56F4\uFF08\u8981\u6C42 <= ${MAX_INDEX_STRING_LENGTH_FOR_INDEX}\uFF09`);
               hasError = true;
             }
-            if (field.unique === true && fieldMax > MAX_INDEX_STRING_LENGTH_FOR_UNIQUE) {
-              Logger.warn(`${tablePrefix}${fileName} \u6587\u4EF6 ${colKey} \u8BBE\u7F6E\u4E86 unique=true\uFF0C` + `\u4F46 max=${fieldMax} \u8D85\u51FA\u5141\u8BB8\u8303\u56F4\uFF08\u8981\u6C42 <= ${MAX_INDEX_STRING_LENGTH_FOR_UNIQUE}\uFF09`);
+            if (field.unique === true && field.max > MAX_INDEX_STRING_LENGTH_FOR_UNIQUE) {
+              Logger.warn(`${tablePrefix}${fileName} \u6587\u4EF6 ${colKey} \u8BBE\u7F6E\u4E86 unique=true\uFF0C` + `\u4F46 max=${field.max} \u8D85\u51FA\u5141\u8BB8\u8303\u56F4\uFF08\u8981\u6C42 <= ${MAX_INDEX_STRING_LENGTH_FOR_UNIQUE}\uFF09`);
               hasError = true;
             }
           }
-          if (fieldDefault !== undefined && fieldDefault !== null) {
-            if (typeof fieldDefault !== "string") {
-              Logger.warn(`${tablePrefix}${fileName} \u6587\u4EF6 ${colKey} \u4E3A ${fieldType} \u7C7B\u578B\uFF0C\u9ED8\u8BA4\u503C\u5FC5\u987B\u4E3A\u5B57\u7B26\u4E32\u6216 null` + `\uFF08typeof=${typeof fieldDefault}\uFF0Cvalue=${formatValuePreview(fieldDefault)}\uFF09`);
+          if (field.default !== undefined && field.default !== null) {
+            if (typeof field.default !== "string") {
+              Logger.warn(`${tablePrefix}${fileName} \u6587\u4EF6 ${colKey} \u4E3A ${field.type} \u7C7B\u578B\uFF0C\u9ED8\u8BA4\u503C\u5FC5\u987B\u4E3A\u5B57\u7B26\u4E32\u6216 null` + `\uFF08typeof=${typeof field.default}\uFF0Cvalue=${formatValuePreview(field.default)}\uFF09`);
               hasError = true;
-            } else if (fieldType !== "string") {
+            } else if (field.type !== "string") {
               try {
-                const parsed = JSON.parse(fieldDefault);
+                const parsed = JSON.parse(field.default);
                 if (!Array.isArray(parsed)) {
-                  Logger.warn(`${tablePrefix}${fileName} \u6587\u4EF6 ${colKey} \u4E3A ${fieldType} \u7C7B\u578B\uFF0C\u9ED8\u8BA4\u503C\u5E94\u4E3A JSON \u6570\u7EC4\u5B57\u7B26\u4E32\uFF08\u4F8B\u5982 "[]"\uFF09` + `\uFF08value=${formatValuePreview(fieldDefault)}\uFF09`);
+                  Logger.warn(`${tablePrefix}${fileName} \u6587\u4EF6 ${colKey} \u4E3A ${field.type} \u7C7B\u578B\uFF0C\u9ED8\u8BA4\u503C\u5E94\u4E3A JSON \u6570\u7EC4\u5B57\u7B26\u4E32\uFF08\u4F8B\u5982 "[]"\uFF09` + `\uFF08value=${formatValuePreview(field.default)}\uFF09`);
                   hasError = true;
                 }
               } catch {
-                Logger.warn(`${tablePrefix}${fileName} \u6587\u4EF6 ${colKey} \u4E3A ${fieldType} \u7C7B\u578B\uFF0C\u9ED8\u8BA4\u503C\u5E94\u4E3A JSON \u6570\u7EC4\u5B57\u7B26\u4E32\uFF08\u4F8B\u5982 "[]"\uFF09` + `\uFF08value=${formatValuePreview(fieldDefault)}\uFF09`);
+                Logger.warn(`${tablePrefix}${fileName} \u6587\u4EF6 ${colKey} \u4E3A ${field.type} \u7C7B\u578B\uFF0C\u9ED8\u8BA4\u503C\u5E94\u4E3A JSON \u6570\u7EC4\u5B57\u7B26\u4E32\uFF08\u4F8B\u5982 "[]"\uFF09` + `\uFF08value=${formatValuePreview(field.default)}\uFF09`);
                 hasError = true;
               }
             }
           }
-        } else if (fieldType === "number") {
-          if (fieldDefault !== undefined && fieldDefault !== null && typeof fieldDefault !== "number") {
-            Logger.warn(`${tablePrefix}${fileName} \u6587\u4EF6 ${colKey} \u4E3A number \u7C7B\u578B\uFF0C\u9ED8\u8BA4\u503C\u5FC5\u987B\u4E3A\u6570\u5B57\u6216 null` + `\uFF08typeof=${typeof fieldDefault}\uFF0Cvalue=${formatValuePreview(fieldDefault)}\uFF09`);
+        } else if (field.type === "number") {
+          if (field.default !== undefined && field.default !== null && typeof field.default !== "number") {
+            Logger.warn(`${tablePrefix}${fileName} \u6587\u4EF6 ${colKey} \u4E3A number \u7C7B\u578B\uFF0C\u9ED8\u8BA4\u503C\u5FC5\u987B\u4E3A\u6570\u5B57\u6216 null` + `\uFF08typeof=${typeof field.default}\uFF0Cvalue=${formatValuePreview(field.default)}\uFF09`);
             hasError = true;
           }
         }
@@ -13324,7 +13384,12 @@ class DbUtils {
     for (const [key, value] of Object.entries(userData)) {
       result[key] = value;
     }
-    result["id"] = options.id;
+    if (options.idMode === "timeId") {
+      if (!Number.isFinite(options.id) || options.id <= 0) {
+        throw new Error(`buildInsertRow(timeId) \u5931\u8D25\uFF1Aid \u5FC5\u987B\u4E3A > 0 \u7684\u6709\u9650 number (id: ${String(options.id)})`);
+      }
+      result["id"] = options.id;
+    }
     result["created_at"] = options.now;
     result["updated_at"] = options.now;
     result["state"] = 1;
@@ -14095,6 +14160,7 @@ class DbHelper {
   dbName;
   sql = null;
   isTransaction = false;
+  idMode;
   constructor(options) {
     this.redis = options.redis;
     if (typeof options.dbName !== "string" || options.dbName.trim() === "") {
@@ -14103,6 +14169,7 @@ class DbHelper {
     this.dbName = options.dbName;
     this.sql = options.sql || null;
     this.isTransaction = Boolean(options.sql);
+    this.idMode = options.idMode === "autoId" ? "autoId" : "timeId";
   }
   createSqlBuilder() {
     return new SqlBuilder({ quoteIdent: quoteIdentMySql });
@@ -14397,13 +14464,18 @@ class DbHelper {
     const { table, data } = options;
     const snakeTable = snakeCase(table);
     const now = Date.now();
-    let id;
-    try {
-      id = await this.redis.genTimeID();
-    } catch (error) {
-      throw new Error(`\u751F\u6210 ID \u5931\u8D25\uFF0CRedis \u53EF\u80FD\u4E0D\u53EF\u7528 (table: ${table})`, { cause: error });
+    let processed;
+    if (this.idMode === "autoId") {
+      processed = DbUtils.buildInsertRow({ idMode: "autoId", data, now });
+    } else {
+      let id;
+      try {
+        id = await this.redis.genTimeID();
+      } catch (error) {
+        throw new Error(`\u751F\u6210 ID \u5931\u8D25\uFF0CRedis \u53EF\u80FD\u4E0D\u53EF\u7528 (table: ${table})`, { cause: error });
+      }
+      processed = DbUtils.buildInsertRow({ idMode: "timeId", data, id, now });
     }
-    const processed = DbUtils.buildInsertRow({ data, id, now });
     SqlCheck.assertNoUndefinedInRecord(processed, `insData \u63D2\u5165\u6570\u636E (table: ${snakeTable})`);
     const builder = this.createSqlBuilder();
     const { sql, params } = builder.toInsertSql(snakeTable, processed);
@@ -14411,7 +14483,10 @@ class DbHelper {
     const processedId = processed["id"];
     const processedIdNum = typeof processedId === "number" ? processedId : 0;
     const lastInsertRowidNum = toNumberFromSql(execRes.data?.lastInsertRowid);
-    const insertedId = processedIdNum || lastInsertRowidNum || 0;
+    const insertedId = this.idMode === "autoId" ? lastInsertRowidNum || 0 : processedIdNum || lastInsertRowidNum || 0;
+    if (this.idMode === "autoId" && insertedId <= 0) {
+      throw new Error(`\u63D2\u5165\u5931\u8D25\uFF1AautoId \u6A21\u5F0F\u4E0B\u65E0\u6CD5\u83B7\u53D6 lastInsertRowid (table: ${table})`);
+    }
     return {
       data: insertedId,
       sql: execRes.sql
@@ -14430,23 +14505,46 @@ class DbHelper {
       throw new Error(`\u6279\u91CF\u63D2\u5165\u6570\u91CF ${dataList.length} \u8D85\u8FC7\u6700\u5927\u9650\u5236 ${MAX_BATCH_SIZE}`);
     }
     const snakeTable = snakeCase(table);
-    const ids = [];
-    for (let i = 0;i < dataList.length; i++) {
-      ids.push(await this.redis.genTimeID());
-    }
     const now = Date.now();
-    const processedList = dataList.map((data, index) => {
-      const id = ids[index];
-      if (typeof id !== "number") {
-        throw new Error(`\u6279\u91CF\u63D2\u5165\u751F\u6210 ID \u5931\u8D25\uFF1Aids[${index}] \u4E0D\u662F number (table: ${snakeTable})`);
+    let ids = [];
+    let processedList;
+    if (this.idMode === "autoId") {
+      processedList = dataList.map((data) => {
+        return DbUtils.buildInsertRow({ idMode: "autoId", data, now });
+      });
+    } else {
+      const nextIds = [];
+      for (let i = 0;i < dataList.length; i++) {
+        nextIds.push(await this.redis.genTimeID());
       }
-      return DbUtils.buildInsertRow({ data, id, now });
-    });
+      ids = nextIds;
+      processedList = dataList.map((data, index) => {
+        const id = nextIds[index];
+        if (typeof id !== "number") {
+          throw new Error(`\u6279\u91CF\u63D2\u5165\u751F\u6210 ID \u5931\u8D25\uFF1Aids[${index}] \u4E0D\u662F number (table: ${snakeTable})`);
+        }
+        return DbUtils.buildInsertRow({ idMode: "timeId", data, id, now });
+      });
+    }
     const insertFields = SqlCheck.assertBatchInsertRowsConsistent(processedList, { table: snakeTable });
     const builder = this.createSqlBuilder();
     const { sql, params } = builder.toInsertSql(snakeTable, processedList);
     try {
       const execRes = await this.executeRun(sql, params);
+      if (this.idMode === "autoId") {
+        const firstId = toNumberFromSql(execRes.data?.lastInsertRowid);
+        if (firstId <= 0) {
+          throw new Error(`\u6279\u91CF\u63D2\u5165\u5931\u8D25\uFF1AautoId \u6A21\u5F0F\u4E0B\u65E0\u6CD5\u83B7\u53D6 lastInsertRowid (table: ${table})`);
+        }
+        const outIds = [];
+        for (let i = 0;i < dataList.length; i++) {
+          outIds.push(firstId + i);
+        }
+        return {
+          data: outIds,
+          sql: execRes.sql
+        };
+      }
       return {
         data: ids,
         sql: execRes.sql
@@ -14600,7 +14698,7 @@ class DbHelper {
       throw new Error("\u5F53\u524D SQL \u5BA2\u6237\u7AEF\u4E0D\u652F\u6301\u4E8B\u52A1 begin() \u65B9\u6CD5");
     }
     return await sql.begin(async (tx) => {
-      const trans = new DbHelper({ redis: this.redis, dbName: this.dbName, sql: tx });
+      const trans = new DbHelper({ redis: this.redis, dbName: this.dbName, sql: tx, idMode: this.idMode });
       return await callback(trans);
     });
   }
@@ -14745,7 +14843,9 @@ var dbPlugin = {
     }
     try {
       const sql = Connect.getSql();
-      const dbManager = new DbHelper({ redis: befly.redis, dbName, sql });
+      const idMode = befly.config?.db?.idMode;
+      const normalizedIdMode = idMode === "autoId" ? "autoId" : "timeId";
+      const dbManager = new DbHelper({ redis: befly.redis, dbName, sql, idMode: normalizedIdMode });
       return dbManager;
     } catch (error) {
       Logger.error({ env, err: error, msg: "\u6570\u636E\u5E93\u521D\u59CB\u5316\u5931\u8D25" });
@@ -15533,7 +15633,7 @@ class Befly {
       const { apis, tables, plugins, hooks, addons } = await scanSources();
       this.context["addons"] = addons;
       await checkApi(apis);
-      await checkTable(tables);
+      await checkTable(tables, this.config);
       await checkPlugin(plugins);
       await checkHook(hooks);
       const checkedMenus = await checkMenu(addons);