befly 3.7.0 → 3.7.2

package/check.ts

@@ -81,16 +81,12 @@ export const checkDefault = async function (): Promise<void> {
         for (const addonName of addons) {
             const addonTablesDir = Addon.getDir(addonName, 'tables');
 
-            try {
-                for await (const file of tablesGlob.scan({
-                    cwd: addonTablesDir,
-                    absolute: true,
-                    onlyFiles: true
-                })) {
-                    allTableFiles.push({ file: file, type: 'addon', addonName: addonName });
-                }
-            } catch (error) {
-                // addon 的 tables 目录可能不存在，跳过
+            for await (const file of tablesGlob.scan({
+                cwd: addonTablesDir,
+                absolute: true,
+                onlyFiles: true
+            })) {
+                allTableFiles.push({ file: file, type: 'addon', addonName: addonName });
             }
         }
 
@@ -124,98 +120,94 @@ export const checkDefault = async function (): Promise<void> {
                     }
 
                     // 验证规则格式
+                    fileRules++;
+                    totalRules++;
+
+                    // 检查是否使用了保留字段
+                    if (RESERVED_FIELDS.includes(colKey as any)) {
+                        Logger.warn(`${fileType}表 ${fileName} 文件包含保留字段 ${colKey}，` + `不能在表定义中使用以下字段: ${RESERVED_FIELDS.join(', ')}`);
+                        fileValid = false;
+                    }
+
+                    // 使用 parseRule 解析字段规则
+                    let parsed;
                     try {
-                        fileRules++;
-                        totalRules++;
+                        parsed = parseRule(rule);
+                    } catch (error: any) {
+                        Logger.warn(`${fileType}表 ${fileName} 文件 ${colKey} 字段规则解析失败：${error.message}`);
+                        fileValid = false;
+                        continue;
+                    }
 
-                        // 检查是否使用了保留字段
-                        if (RESERVED_FIELDS.includes(colKey as any)) {
-                            Logger.warn(`${fileType}表 ${fileName} 文件包含保留字段 ${colKey}，` + `不能在表定义中使用以下字段: ${RESERVED_FIELDS.join(', ')}`);
-                            fileValid = false;
-                        }
+                    const { name: fieldName, type: fieldType, min: fieldMin, max: fieldMax, default: fieldDefault, index: fieldIndex, regex: fieldRegx } = parsed;
 
-                        // 使用 parseRule 解析字段规则
-                        let parsed;
-                        try {
-                            parsed = parseRule(rule);
-                        } catch (error: any) {
-                            Logger.warn(`${fileType}表 ${fileName} 文件 ${colKey} 字段规则解析失败：${error.message}`);
-                            fileValid = false;
-                            continue;
-                        }
+                    // 第1个值：名称必须为中文、数字、字母、下划线、短横线、空格
+                    if (!FIELD_NAME_REGEX.test(fieldName)) {
+                        Logger.warn(`${fileType}表 ${fileName} 文件 ${colKey} 字段名称 "${fieldName}" 格式错误，` + `必须为中文、数字、字母、下划线、短横线、空格`);
+                        fileValid = false;
+                    }
+
+                    // 第2个值：字段类型必须为string,number,text,array_string,array_text之一
+                    if (!FIELD_TYPES.includes(fieldType as any)) {
+                        Logger.warn(`${fileType}表 ${fileName} 文件 ${colKey} 字段类型 "${fieldType}" 格式错误，` + `必须为${FIELD_TYPES.join('、')}之一`);
+                        fileValid = false;
+                    }
 
-                        const { name: fieldName, type: fieldType, min: fieldMin, max: fieldMax, default: fieldDefault, index: fieldIndex, regex: fieldRegx } = parsed;
+                    // 第3/4个值：需要是 null 或 数字
+                    if (!(fieldMin === null || typeof fieldMin === 'number')) {
+                        Logger.warn(`${fileType}表 ${fileName} 文件 ${colKey} 最小值 "${fieldMin}" 格式错误，必须为null或数字`);
+                        fileValid = false;
+                    }
+                    if (!(fieldMax === null || typeof fieldMax === 'number')) {
+                        Logger.warn(`${fileType}表 ${fileName} 文件 ${colKey} 最大值 "${fieldMax}" 格式错误，必须为null或数字`);
+                        fileValid = false;
+                    }
 
-                        // 第1个值：名称必须为中文、数字、字母、下划线、短横线、空格
-                        if (!FIELD_NAME_REGEX.test(fieldName)) {
-                            Logger.warn(`${fileType}表 ${fileName} 文件 ${colKey} 字段名称 "${fieldName}" 格式错误，` + `必须为中文、数字、字母、下划线、短横线、空格`);
+                    // 约束：当最小值与最大值均为数字时，要求最小值 <= 最大值
+                    if (fieldMin !== null && fieldMax !== null) {
+                        if (fieldMin > fieldMax) {
+                            Logger.warn(`${fileType}表 ${fileName} 文件 ${colKey} 最小值 "${fieldMin}" 不能大于最大值 "${fieldMax}"`);
                             fileValid = false;
                         }
+                    }
 
-                        // 第2个值：字段类型必须为string,number,text,array_string,array_text之一
-                        if (!FIELD_TYPES.includes(fieldType as any)) {
-                            Logger.warn(`${fileType}表 ${fileName} 文件 ${colKey} 字段类型 "${fieldType}" 格式错误，` + `必须为${FIELD_TYPES.join('、')}之一`);
-                            fileValid = false;
-                        }
+                    // 第6个值：是否创建索引必须为0或1
+                    if (fieldIndex !== 0 && fieldIndex !== 1) {
+                        Logger.warn(`${fileType}表 ${fileName} 文件 ${colKey} 索引标识 "${fieldIndex}" 格式错误，必须为0或1`);
+                        fileValid = false;
+                    }
+
+                    // 第7个值：必须为null或正则表达式（parseRule已经验证过了）
+                    // parseRule 已经将正则字符串转换为 RegExp 或 null，这里不需要再验证
 
-                        // 第3/4个值：需要是 null 或 数字
-                        if (!(fieldMin === null || typeof fieldMin === 'number')) {
-                            Logger.warn(`${fileType}表 ${fileName} 文件 ${colKey} 最小值 "${fieldMin}" 格式错误，必须为null或数字`);
+                    // 第4个值与类型联动校验 + 默认值规则
+                    if (fieldType === 'text') {
+                        // text：min/max 必须为 null，默认值必须为 'null'
+                        if (fieldMin !== null) {
+                            Logger.warn(`${fileType}表 ${fileName} 文件 ${colKey} 的 text 类型最小值必须为 null，当前为 "${fieldMin}"`);
                             fileValid = false;
                         }
-                        if (!(fieldMax === null || typeof fieldMax === 'number')) {
-                            Logger.warn(`${fileType}表 ${fileName} 文件 ${colKey} 最大值 "${fieldMax}" 格式错误，必须为null或数字`);
+                        if (fieldMax !== null) {
+                            Logger.warn(`${fileType}表 ${fileName} 文件 ${colKey} 的 text 类型最大长度必须为 null，当前为 "${fieldMax}"`);
                             fileValid = false;
                         }
-
-                        // 约束：当最小值与最大值均为数字时，要求最小值 <= 最大值
-                        if (fieldMin !== null && fieldMax !== null) {
-                            if (fieldMin > fieldMax) {
-                                Logger.warn(`${fileType}表 ${fileName} 文件 ${colKey} 最小值 "${fieldMin}" 不能大于最大值 "${fieldMax}"`);
-                                fileValid = false;
-                            }
+                        if (fieldDefault !== 'null') {
+                            Logger.warn(`${fileType}表 ${fileName} 文件 ${colKey} 为 text 类型，默认值必须为 null，当前为 "${fieldDefault}"`);
+                            fileValid = false;
                         }
-
-                        // 第6个值：是否创建索引必须为0或1
-                        if (fieldIndex !== 0 && fieldIndex !== 1) {
-                            Logger.warn(`${fileType}表 ${fileName} 文件 ${colKey} 索引标识 "${fieldIndex}" 格式错误，必须为0或1`);
+                    } else if (fieldType === 'string' || fieldType === 'array') {
+                        if (fieldMax === null || typeof fieldMax !== 'number') {
+                            Logger.warn(`${fileType}表 ${fileName} 文件 ${colKey} 为 ${fieldType} 类型，` + `最大长度必须为数字，当前为 "${fieldMax}"`);
+                            fileValid = false;
+                        } else if (fieldMax > MAX_VARCHAR_LENGTH) {
+                            Logger.warn(`${fileType}表 ${fileName} 文件 ${colKey} 最大长度 ${fieldMax} 越界，` + `${fieldType} 类型长度必须在 1..${MAX_VARCHAR_LENGTH} 范围内`);
                             fileValid = false;
                         }
-
-                        // 第7个值：必须为null或正则表达式（parseRule已经验证过了）
-                        // parseRule 已经将正则字符串转换为 RegExp 或 null，这里不需要再验证
-
-                        // 第4个值与类型联动校验 + 默认值规则
-                        if (fieldType === 'text') {
-                            // text：min/max 必须为 null，默认值必须为 'null'
-                            if (fieldMin !== null) {
-                                Logger.warn(`${fileType}表 ${fileName} 文件 ${colKey} 的 text 类型最小值必须为 null，当前为 "${fieldMin}"`);
-                                fileValid = false;
-                            }
-                            if (fieldMax !== null) {
-                                Logger.warn(`${fileType}表 ${fileName} 文件 ${colKey} 的 text 类型最大长度必须为 null，当前为 "${fieldMax}"`);
-                                fileValid = false;
-                            }
-                            if (fieldDefault !== 'null') {
-                                Logger.warn(`${fileType}表 ${fileName} 文件 ${colKey} 为 text 类型，默认值必须为 null，当前为 "${fieldDefault}"`);
-                                fileValid = false;
-                            }
-                        } else if (fieldType === 'string' || fieldType === 'array') {
-                            if (fieldMax === null || typeof fieldMax !== 'number') {
-                                Logger.warn(`${fileType}表 ${fileName} 文件 ${colKey} 为 ${fieldType} 类型，` + `最大长度必须为数字，当前为 "${fieldMax}"`);
-                                fileValid = false;
-                            } else if (fieldMax > MAX_VARCHAR_LENGTH) {
-                                Logger.warn(`${fileType}表 ${fileName} 文件 ${colKey} 最大长度 ${fieldMax} 越界，` + `${fieldType} 类型长度必须在 1..${MAX_VARCHAR_LENGTH} 范围内`);
-                                fileValid = false;
-                            }
-                        } else if (fieldType === 'number') {
-                            if (fieldDefault !== 'null' && typeof fieldDefault !== 'number') {
-                                Logger.warn(`${fileType}表 ${fileName} 文件 ${colKey} 为 number 类型，` + `默认值必须为数字或null，当前为 "${fieldDefault}"`);
-                                fileValid = false;
-                            }
+                    } else if (fieldType === 'number') {
+                        if (fieldDefault !== 'null' && typeof fieldDefault !== 'number') {
+                            Logger.warn(`${fileType}表 ${fileName} 文件 ${colKey} 为 number 类型，` + `默认值必须为数字或null，当前为 "${fieldDefault}"`);
+                            fileValid = false;
                         }
-                    } catch (error: any) {
-                        // 单个字段规则解析失败已在上面处理
                     }
                 }
 
@@ -226,7 +218,7 @@ export const checkDefault = async function (): Promise<void> {
                     invalidFiles++;
                 }
             } catch (error: any) {
-                Logger.error(`${fileType}表 ${fileName} 解析失败: ${error.message}`);
+                Logger.error(`${fileType}表 ${fileName} 解析失败`, error);
                 invalidFiles++;
             }
         }
@@ -241,7 +233,7 @@ export const checkDefault = async function (): Promise<void> {
             throw new Error('表定义检查失败，请修复上述错误后重试');
         }
     } catch (error: any) {
-        Logger.error('数据表定义检查过程中出错:', error);
+        Logger.error('数据表定义检查过程中出错', error);
         throw error;
     }
 };

package/lib/database.ts

@@ -94,7 +94,7 @@ export class Database {
             Logger.error('数据库连接测试失败', error);
 
             try {
-                await sql.close();
+                await sql?.close();
             } catch (cleanupError) {}
 
             throw error;
@@ -109,7 +109,7 @@ export class Database {
             try {
                 await this.sqlClient.close();
             } catch (error: any) {
-                Logger.warn('关闭 SQL 连接时出错:', error.message);
+                Logger.error('关闭 SQL 连接时出错', error);
             }
             this.sqlClient = null;
         }
@@ -200,7 +200,7 @@ export class Database {
             try {
                 this.redisClient.close();
             } catch (error: any) {
-                Logger.warn('关闭 Redis 连接时出错:', error);
+                Logger.error('关闭 Redis 连接时出错', error);
             }
             this.redisClient = null;
         }

package/lib/dbHelper.ts

@@ -410,7 +410,7 @@ export class DbHelper {
         try {
             processed.id = await this.befly.redis.genTimeID();
         } catch (error: any) {
-            throw new Error(`生成 ID 失败，Redis 可能不可用 (table: ${table}): ${error.message}`);
+            throw new Error(`生成 ID 失败，Redis 可能不可用 (table: ${table})`, error);
         }
 
         // 强制生成时间戳（不可被用户覆盖）
@@ -634,7 +634,7 @@ export class DbHelper {
                     await conn.query('ROLLBACK');
                     Logger.warn('事务已回滚');
                 } catch (rollbackError: any) {
-                    Logger.error('事务回滚失败:', rollbackError);
+                    Logger.error('事务回滚失败', rollbackError);
                 }
             }
             throw error;

package/lib/middleware.ts

@@ -132,8 +132,8 @@ export async function parsePostParams(api: ApiRoute, ctx: RequestContext): Promi
         }
 
         return true;
-    } catch (err: any) {
-        Logger.error('处理请求参数时发生错误', err);
+    } catch (error: any) {
+        Logger.error('处理请求参数时发生错误', error);
         return false;
     }
 }

package/lifecycle/lifecycle.ts

@@ -53,7 +53,6 @@ export class Lifecycle {
 
         // 4. 启动 HTTP 服务器
         const totalStartupTime = calcPerfTime(serverStartTime);
-        Logger.info(`✓ 服务器启动准备完成，总耗时: ${totalStartupTime}`);
 
         return await Bootstrap.start(
             {

package/lifecycle/loader.ts

@@ -212,7 +212,6 @@ export class Loader {
                         }
                     }
                     const addonPluginsInitTime = calcPerfTime(addonPluginsInitStart);
-                    Logger.info(`✓ 组件插件加载完成: ${addonPlugins.length} 个，耗时: ${addonPluginsScanTime}`);
                 }
             }
 
@@ -275,12 +274,10 @@ export class Loader {
                     }
                 }
                 const userPluginsInitTime = calcPerfTime(userPluginsInitStart);
-                Logger.info(`✓ 用户插件加载完成: ${sortedUserPlugins.length} 个，耗时: ${userPluginsInitTime}`);
             }
 
             const totalLoadTime = calcPerfTime(loadStartTime);
             const totalPluginCount = sortedCorePlugins.length + addonPlugins.length + sortedUserPlugins.length;
-            Logger.info(`✓ 所有插件加载完成: ${totalPluginCount} 个，总耗时: ${totalLoadTime}`);
 
             // 核心插件失败 → 关键错误，必须退出
             if (hadCorePluginError) {
@@ -412,7 +409,6 @@ export class Loader {
             }
 
             const totalLoadTime = calcPerfTime(loadStartTime);
-            Logger.info(`✓ ${dirDisplayName}接口加载完成: ${loadedApis}/${totalApis}，耗时: ${totalLoadTime}`);
 
             // 检查是否有加载失败的 API（理论上不会到达这里，因为上面已经 critical 退出）
             if (failedApis > 0) {

package/main.ts

@@ -41,23 +41,20 @@ export class Befly {
     async listen(callback?: (server: Server) => void): Promise<Server> {
         const server = await this.lifecycle.start(this.appContext, callback);
 
-        // 注册优雅关闭信号处理器
         const gracefulShutdown = async (signal: string) => {
-            Logger.info(`\n收到 ${signal} 信号，开始优雅关闭...`);
-
             // 1. 停止接收新请求
             server.stop(true);
-            Logger.info('✅ HTTP 服务器已停止');
+            Logger.info('HTTP 服务器已停止');
 
             // 2. 关闭数据库连接
             try {
                 await Database.disconnect();
-                Logger.info('✅ 数据库连接已关闭');
+                Logger.info('数据库连接已关闭');
             } catch (error: any) {
-                Logger.warn('⚠️ 关闭数据库连接时出错:', error.message);
+                Logger.err('关闭数据库连接时出错:', error);
             }
 
-            Logger.info('✅ 服务器已优雅关闭');
+            Logger.info('服务器已优雅关闭');
             process.exit(0);
         };
 

package/menu.json

@@ -7,61 +7,49 @@
         "type": 1
     },
     {
-        "name": "管理员管理",
-        "path": "/admin",
-        "icon": "Users",
+        "name": "人员管理",
+        "path": "/people",
+        "icon": "UserCircle",
         "sort": 2,
-        "type": 1
+        "type": 1,
+        "children": [
+            {
+                "name": "管理员管理",
+                "path": "/admin",
+                "icon": "Users",
+                "sort": 2,
+                "type": 1
+            }
+        ]
     },
     {
-        "name": "新闻管理",
-        "path": "/news",
-        "icon": "Newspaper",
+        "name": "权限设置",
+        "path": "/settings",
+        "icon": "Settings",
         "sort": 3,
-        "type": 1
-    },
-    {
-        "name": "菜单管理",
-        "path": "/menu",
-        "icon": "Menu",
-        "sort": 4,
-        "type": 1
-    },
-    {
-        "name": "角色管理",
-        "path": "/role",
-        "icon": "Users",
-        "sort": 5,
-        "type": 1
-    },
-    {
-        "name": "字典管理",
-        "path": "/dict",
-        "icon": "BookOpen",
-        "sort": 6,
-        "type": 1
-    },
-    {
-        "name": "用户管理",
-        "path": "/user",
-        "icon": "UserCog",
-        "sort": 7,
         "type": 1,
         "children": [
             {
-                "name": "用户列表",
-                "path": "/list",
-                "icon": "Minus",
-                "sort": 1,
+                "name": "菜单管理",
+                "path": "/menu",
+                "icon": "Menu",
+                "sort": 4,
                 "type": 1
             },
             {
-                "name": "用户权限",
-                "path": "/permission",
-                "icon": "Minus",
-                "sort": 2,
+                "name": "角色管理",
+                "path": "/role",
+                "icon": "Users",
+                "sort": 5,
                 "type": 1
             }
         ]
+    },
+    {
+        "name": "字典管理",
+        "path": "/dict",
+        "icon": "BookOpen",
+        "sort": 6,
+        "type": 1
     }
 ]

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "befly",
-    "version": "3.7.0",
+    "version": "3.7.2",
     "description": "Befly - 为 Bun 专属打造的 TypeScript API 接口框架核心引擎",
     "type": "module",
     "private": false,
@@ -69,5 +69,5 @@
         "es-toolkit": "^1.41.0",
         "pathe": "^2.0.3"
     },
-    "gitHead": "cdd2d42fdd5e0f887b434fa70dff72028d9e31ed"
+    "gitHead": "4e67637bf6481e2455901b0dba798bfa52236898"
 }

package/router/api.ts

@@ -115,7 +115,7 @@ export function apiHandler(apiRoutes: Map<string, ApiRoute>, pluginLists: Plugin
             }
         } catch (error: any) {
             // 记录详细的错误日志
-            Logger.warn(api ? `接口 [${api.name}] 执行失败` : '处理接口请求时发生错误', error);
+            Logger.error(api ? `接口 [${api.name}] 执行失败` : '处理接口请求时发生错误', error);
 
             return Response.json(No('内部服务器错误'), {
                 headers: corsOptions.headers