befly 3.75.0 → 3.75.1

package/checks/api.js

@@ -67,7 +67,8 @@ export async function checkApi(apis) {
         apis.forEach((api, index) => issues.push(...checkApiItem(api, index)));
     }
 
-    if (issues.length === 0) return false;
-    Logger.warn("接口校验失败", { errors: formatValidationIssues(issues, { items: apis, itemLabel: "api" }) });
-    return true;
+    if (issues.length === 0) return [];
+    const errors = formatValidationIssues(issues, { items: apis, itemLabel: "api" });
+    Logger.warn("接口校验失败", { errors: errors });
+    return errors;
 }

package/checks/config.js

@@ -4,14 +4,15 @@ import { formatValidationIssues } from "../utils/formatValidationIssues.js";
 
 export async function checkConfig(config) {
     const issues = validateConfig(config);
-    if (issues.length === 0) return false;
+    if (issues.length === 0) return [];
 
+    const errors = formatValidationIssues(issues, { item: config, itemLabel: "config" });
     Logger.warn(
         "配置校验失败",
         {
-            errors: formatValidationIssues(issues, { item: config, itemLabel: "config" })
+            errors: errors
         },
         false
     );
-    return true;
+    return errors;
 }

package/checks/items.js

@@ -24,11 +24,12 @@ function checkItem(item) {
 
 function checkItemList(items, label, labelEn) {
     if (!Array.isArray(items)) {
-        Logger.warn(`${label}校验失败`, { errors: formatValidationIssues([{ path: [], message: "必须是数组" }], { item: items, itemLabel: labelEn }) });
-        return true;
+        const errors = formatValidationIssues([{ path: [], message: "必须是数组" }], { item: items, itemLabel: labelEn });
+        Logger.warn(`${label}校验失败`, { errors: errors });
+        return errors;
     }
 
-    let hasError = false;
+    const errors = [];
 
     // order 冲突校验：同 order 的执行顺序依赖扫描顺序，要求显式区分
     const orderMap = new Map();
@@ -38,17 +39,25 @@ function checkItemList(items, label, labelEn) {
     }
     const duplicateOrders = [...orderMap].filter(([, count]) => count > 1).map(([order]) => order);
     if (duplicateOrders.length > 0) {
-        Logger.warn(`${label}校验失败`, { errors: [{ path: [], message: `order 重复: ${duplicateOrders.join("、")}` }] });
-        hasError = true;
+        const duplicateItems = items.filter((item) => duplicateOrders.includes(item.order));
+        errors.push(
+            ...formatValidationIssues(
+                duplicateItems.map((item, index) => ({ path: [index], message: `order ${item.order} 重复，请显式区分` })),
+                { items: duplicateItems, itemLabel: labelEn }
+            )
+        );
     }
 
     for (const item of items) {
         const issues = checkItem(item);
         if (issues.length === 0) continue;
-        Logger.warn(`${label}校验失败`, { errors: formatValidationIssues(issues, { item: item, itemLabel: labelEn }) });
-        hasError = true;
+        errors.push(...formatValidationIssues(issues, { item: item, itemLabel: labelEn }));
     }
-    return hasError;
+
+    if (errors.length > 0) {
+        Logger.warn(`${label}校验失败`, { errors: errors });
+    }
+    return errors;
 }
 
 export const checkHook = (hooks) => checkItemList(hooks, "钩子", "hook");

package/checks/menu.js

@@ -42,7 +42,8 @@ export async function checkMenu(menus) {
     if (!Array.isArray(menus)) issues.push({ path: [], message: "必须是数组" });
     else menus.forEach((menu, index) => checkMenuItem(issues, menu, [index]));
 
-    if (issues.length === 0) return false;
-    Logger.warn("菜单校验失败", { errors: formatValidationIssues(issues, { items: menus, itemLabel: "menus" }) });
-    return true;
+    if (issues.length === 0) return [];
+    const errors = formatValidationIssues(issues, { items: menus, itemLabel: "menus" });
+    Logger.warn("菜单校验失败", { errors: errors });
+    return errors;
 }

package/checks/table.js

@@ -35,7 +35,8 @@ export async function checkTable(tables) {
         }
     }
 
-    if (issues.length === 0) return false;
-    Logger.warn("表结构校验失败", { errors: formatValidationIssues(issues, { item: tables, itemLabel: "table" }) });
-    return true;
+    if (issues.length === 0) return [];
+    const errors = formatValidationIssues(issues, { item: tables, itemLabel: "table" });
+    Logger.warn("表结构校验失败", { errors: errors });
+    return errors;
 }

package/index.js

@@ -104,7 +104,7 @@ export async function createBefly(config = {}, menus = []) {
     Logger.info(`启动 合并配置 耗时 ${calcPerfTime(mergeStartTime)}`);
 
     let stageStartTime = Bun.nanoseconds();
-    const configHasError = await checkConfig(mergedConfig);
+    const configErrors = await checkConfig(mergedConfig);
     Logger.info(`启动 检查配置 耗时 ${calcPerfTime(stageStartTime)}`);
 
     stageStartTime = Bun.nanoseconds();
@@ -112,27 +112,42 @@ export async function createBefly(config = {}, menus = []) {
     Logger.info(`启动 扫描源码 耗时 ${calcPerfTime(stageStartTime)}`);
 
     stageStartTime = Bun.nanoseconds();
-    const apiHasError = await checkApi(apis);
+    const apiErrors = await checkApi(apis);
     Logger.info(`启动 检查接口 耗时 ${calcPerfTime(stageStartTime)}`);
 
     stageStartTime = Bun.nanoseconds();
-    const tableHasError = await checkTable(tables);
+    const tableErrors = await checkTable(tables);
     Logger.info(`启动 检查表 耗时 ${calcPerfTime(stageStartTime)}`);
 
     stageStartTime = Bun.nanoseconds();
-    const pluginHasError = await checkPlugin(plugins);
+    const pluginErrors = await checkPlugin(plugins);
     Logger.info(`启动 检查插件 耗时 ${calcPerfTime(stageStartTime)}`);
 
     stageStartTime = Bun.nanoseconds();
-    const hookHasError = await checkHook(hooks);
+    const hookErrors = await checkHook(hooks);
     Logger.info(`启动 检查钩子 耗时 ${calcPerfTime(stageStartTime)}`);
 
     stageStartTime = Bun.nanoseconds();
-    const menuHasError = await checkMenu(mergedMenus);
+    const menuErrors = await checkMenu(mergedMenus);
     Logger.info(`启动 检查菜单 耗时 ${calcPerfTime(stageStartTime)}`);
 
-    if (configHasError || apiHasError || tableHasError || pluginHasError || hookHasError || menuHasError) {
-        throw createError("检查失败：存在配置/结构问题", { code: "policy", subsystem: "checks", operation: "checkAll" });
+    // 汇总各检查明细，报错可直接定位到具体文件/路径/配置/字段
+    const failedChecks = [
+        { check: "配置", errors: configErrors },
+        { check: "接口", errors: apiErrors },
+        { check: "表结构", errors: tableErrors },
+        { check: "插件", errors: pluginErrors },
+        { check: "钩子", errors: hookErrors },
+        { check: "菜单", errors: menuErrors }
+    ].filter((entry) => entry.errors.length > 0);
+
+    if (failedChecks.length > 0) {
+        throw createError("检查失败：存在配置/结构问题", {
+            code: "policy",
+            subsystem: "checks",
+            operation: "checkAll",
+            errors: failedChecks
+        });
     }
 
     // 运行模式以环境为准（NODE_ENV，线上部署注入 production；本地开发默认 development），

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "befly",
-    "version": "3.75.0",
+    "version": "3.75.1",
     "gitHead": "49c39d36695036e85fc64083cc43c1652fff96cb",
     "private": false,
     "description": "Befly - 为 Bun 专属打造的 JavaScript API 接口框架核心引擎",