befly 3.12.1 → 3.12.3

package/dist/index.js

@@ -134,35 +134,32 @@ export class Befly {
             Logger.info(`${this.config.appName} 启动成功! (${roleLabel}${envLabel})`);
             Logger.info(`服务器启动耗时: ${finalStartupTime}`);
             Logger.info(`服务器监听地址: ${server.url}`);
-            // 7. 注册优雅关闭处理
-            const gracefulShutdown = async (signal) => {
-                Logger.info(`收到 ${signal} 信号，开始优雅关闭...`);
-                // 优雅停止（等待进行中的请求完成）
-                try {
-                    await server.stop();
-                    Logger.info("HTTP 服务器已停止");
-                }
-                catch (error) {
-                    Logger.error({ err: error }, "停止 HTTP 服务器时出错");
-                }
-                // 关闭数据库连接
-                try {
-                    await Connect.disconnect();
-                    Logger.info("数据库连接已关闭");
-                }
-                catch (error) {
-                    Logger.error({ err: error }, "关闭数据库连接时出错");
-                }
-                Logger.info("服务器已优雅关闭");
-                process.exit(0);
-            };
-            process.on("SIGTERM", () => gracefulShutdown("SIGTERM"));
-            process.on("SIGINT", () => gracefulShutdown("SIGINT"));
+            // 注意：作为库代码，这里不注册 SIGINT/SIGTERM 处理器，也不调用 process.exit。
+            // 宿主应用应自行处理信号并决定退出策略（包括是否调用 server.stop / Connect.disconnect / Logger.flush）。
             return server;
         }
         catch (error) {
+            // 注意：这里不能直接 process.exit(1)
+            // - Logger 是异步缓冲写入，exit 会导致日志来不及 flush（实际项目里表现为“完全没打印”）
+            // - 作为库代码，也不应该强行终止宿主进程
             Logger.error({ err: error }, "项目启动失败");
-            process.exit(1);
+            // 尽力把错误日志落盘/输出后再把异常抛给上层。
+            try {
+                await Logger.flush();
+            }
+            catch {
+                // ignore
+            }
+            try {
+                await Logger.shutdown();
+            }
+            catch {
+                // ignore
+            }
+            if (error instanceof Error) {
+                throw error;
+            }
+            throw new Error(String(error));
         }
     }
 }

package/dist/lib/logger.js

@@ -57,65 +57,12 @@ let appConsoleSink = null;
 let didWarnIoError = false;
 let didPruneOldLogFiles = false;
 let didEnsureLogDir = false;
-let didInstallGracefulExitHooks = false;
 let config = {
     debug: 0,
     dir: "./logs",
     console: 1,
     maxSize: 10
 };
-function installGracefulExitHooks() {
-    if (didInstallGracefulExitHooks)
-        return;
-    didInstallGracefulExitHooks = true;
-    const install = (signal, exitCode) => {
-        // 若业务侧已经注册了 handler，避免我们抢占默认行为
-        try {
-            if (typeof process.listenerCount === "function" && process.listenerCount(signal) > 0) {
-                return;
-            }
-        }
-        catch {
-            // ignore
-        }
-        try {
-            process.once(signal, () => {
-                let exited = false;
-                // 给 flush 一个机会；超过上限则强制退出
-                const timer = setTimeout(() => {
-                    if (exited)
-                        return;
-                    exited = true;
-                    try {
-                        process.exit(exitCode);
-                    }
-                    catch {
-                        // ignore
-                    }
-                }, 2000);
-                void shutdown()
-                    .catch(() => undefined)
-                    .finally(() => {
-                    if (exited)
-                        return;
-                    exited = true;
-                    clearTimeout(timer);
-                    try {
-                        process.exit(exitCode);
-                    }
-                    catch {
-                        // ignore
-                    }
-                });
-            });
-        }
-        catch {
-            // ignore
-        }
-    };
-    install("SIGINT", 130);
-    install("SIGTERM", 143);
-}
 function formatLocalDate(date) {
     const y = date.getFullYear();
     const m = date.getMonth() + 1;
@@ -467,6 +414,8 @@ export async function shutdown() {
     appConsoleSink = null;
     instance = null;
     errorInstance = null;
+    // shutdown 后允许下一次重新初始化时再次校验/创建目录（测试会清理目录，避免 ENOENT）
+    didEnsureLogDir = false;
 }
 function normalizePositiveInt(value, fallback, min, max) {
     if (typeof value !== "number")
@@ -488,9 +437,6 @@ function resolveLogDir() {
     return nodePathResolve(INITIAL_CWD, rawDir);
 }
 function ensureLogDirExists() {
-    if (didEnsureLogDir)
-        return;
-    didEnsureLogDir = true;
     const dir = resolveLogDir();
     try {
         if (!existsSync(dir)) {
@@ -501,6 +447,7 @@ function ensureLogDirExists() {
         // 不能在 Logger 初始化前调用 Logger 本身，直接抛错即可
         throw new Error(`创建 logs 目录失败: ${dir}. ${error?.message || error}`);
     }
+    didEnsureLogDir = true;
 }
 async function pruneOldLogFiles() {
     if (didPruneOldLogFiles)
@@ -627,7 +574,6 @@ export function getLogger() {
     if (instance)
         return instance;
     ensureLogDirExists();
-    installGracefulExitHooks();
     // 启动时清理过期日志（异步，不阻塞初始化）
     void pruneOldLogFiles();
     const minLevel = normalizeLogLevelName();
@@ -647,7 +593,6 @@ function getErrorLogger() {
     if (errorInstance)
         return errorInstance;
     ensureLogDirExists();
-    installGracefulExitHooks();
     void pruneOldLogFiles();
     const maxFileBytes = (typeof config.maxSize === "number" && config.maxSize > 0 ? config.maxSize : 10) * 1024 * 1024;
     if (!errorFileSink) {

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "befly",
-    "version": "3.12.1",
-    "gitHead": "2ff9d8fc0422aa7332afdd7c19d16493004cdfcf",
+    "version": "3.12.3",
+    "gitHead": "f940226faa94e51a2593cc826b255acd8cf882c6",
     "private": false,
     "description": "Befly - 为 Bun 专属打造的 TypeScript API 接口框架核心引擎",
     "keywords": [