@dangao/bun-server 1.8.2 → 1.9.0

package/dist/middleware/builtin/error-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../../src/middleware/builtin/error-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAOhD,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAE7E;;OAEG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,GAAE,mBAAwB,GAChC,UAAU,CA4DZ"}
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../../src/middleware/builtin/error-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAOhD,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAE7E;;OAEG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,GAAE,mBAAwB,GAChC,UAAU,CAsEZ"}

package/dist/middleware/builtin/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/middleware/builtin/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAGhD,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IAEtE;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,GAAE,uBAA4B,GACpC,UAAU,CAsBZ;AAED,MAAM,WAAW,qBAAsB,SAAQ,uBAAuB;IACpE;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAC5C,OAAO,GAAE,qBAA0B,GAClC,UAAU,CAkCZ"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/middleware/builtin/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAGhD,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IAEtE;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,GAAE,uBAA4B,GACpC,UAAU,CA8BZ;AAED,MAAM,WAAW,qBAAsB,SAAQ,uBAAuB;IACpE;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAC5C,OAAO,GAAE,qBAA0B,GAClC,UAAU,CA2CZ"}

package/dist/router/decorators.d.ts

@@ -19,27 +19,27 @@ export interface RouteMetadata {
 }
 /**
  * GET 路由装饰器
- * @param path - 路由路径
+ * @param path - 路由路径（可选，默认 ''，即 @GET() 映射到控制器基础路径或 /）
  */
-export declare function GET(path: string): (target: any, propertyKey: string | symbol, descriptor: PropertyDescriptor) => void;
+export declare function GET(path?: string): (target: any, propertyKey: string | symbol, descriptor: PropertyDescriptor) => void;
 /**
  * POST 路由装饰器
- * @param path - 路由路径
+ * @param path - 路由路径（可选，默认 ''）
  */
-export declare function POST(path: string): (target: any, propertyKey: string | symbol, descriptor: PropertyDescriptor) => void;
+export declare function POST(path?: string): (target: any, propertyKey: string | symbol, descriptor: PropertyDescriptor) => void;
 /**
  * PUT 路由装饰器
- * @param path - 路由路径
+ * @param path - 路由路径（可选，默认 ''）
  */
-export declare function PUT(path: string): (target: any, propertyKey: string | symbol, descriptor: PropertyDescriptor) => void;
+export declare function PUT(path?: string): (target: any, propertyKey: string | symbol, descriptor: PropertyDescriptor) => void;
 /**
  * DELETE 路由装饰器
- * @param path - 路由路径
+ * @param path - 路由路径（可选，默认 ''）
  */
-export declare function DELETE(path: string): (target: any, propertyKey: string | symbol, descriptor: PropertyDescriptor) => void;
+export declare function DELETE(path?: string): (target: any, propertyKey: string | symbol, descriptor: PropertyDescriptor) => void;
 /**
  * PATCH 路由装饰器
- * @param path - 路由路径
+ * @param path - 路由路径（可选，默认 ''）
  */
-export declare function PATCH(path: string): (target: any, propertyKey: string | symbol, descriptor: PropertyDescriptor) => void;
+export declare function PATCH(path?: string): (target: any, propertyKey: string | symbol, descriptor: PropertyDescriptor) => void;
 //# sourceMappingURL=decorators.d.ts.map

package/dist/router/decorators.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../../src/router/decorators.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAG1C;;GAEG;AACH,eAAO,MAAM,kBAAkB,eAAkB,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,YAAY,CAAC;IACtB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AA8DD;;;GAGG;AACH,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,YAzDL,GAAG,eAAe,MAAM,GAAG,MAAM,cAAc,kBAAkB,UA2D3F;AAED;;;GAGG;AACH,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,YAjEN,GAAG,eAAe,MAAM,GAAG,MAAM,cAAc,kBAAkB,UAmE3F;AAED;;;GAGG;AACH,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,YAzEL,GAAG,eAAe,MAAM,GAAG,MAAM,cAAc,kBAAkB,UA2E3F;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,YAjFR,GAAG,eAAe,MAAM,GAAG,MAAM,cAAc,kBAAkB,UAmF3F;AAED;;;GAGG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,YAzFP,GAAG,eAAe,MAAM,GAAG,MAAM,cAAc,kBAAkB,UA2F3F"}
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../../src/router/decorators.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAG1C;;GAEG;AACH,eAAO,MAAM,kBAAkB,eAAkB,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,YAAY,CAAC;IACtB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AA8DD;;;GAGG;AACH,wBAAgB,GAAG,CAAC,IAAI,GAAE,MAAW,YAzDV,GAAG,eAAe,MAAM,GAAG,MAAM,cAAc,kBAAkB,UA2D3F;AAED;;;GAGG;AACH,wBAAgB,IAAI,CAAC,IAAI,GAAE,MAAW,YAjEX,GAAG,eAAe,MAAM,GAAG,MAAM,cAAc,kBAAkB,UAmE3F;AAED;;;GAGG;AACH,wBAAgB,GAAG,CAAC,IAAI,GAAE,MAAW,YAzEV,GAAG,eAAe,MAAM,GAAG,MAAM,cAAc,kBAAkB,UA2E3F;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,IAAI,GAAE,MAAW,YAjFb,GAAG,eAAe,MAAM,GAAG,MAAM,cAAc,kBAAkB,UAmF3F;AAED;;;GAGG;AACH,wBAAgB,KAAK,CAAC,IAAI,GAAE,MAAW,YAzFZ,GAAG,eAAe,MAAM,GAAG,MAAM,cAAc,kBAAkB,UA2F3F"}

package/dist/router/router.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/router/router.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD;;;GAGG;AACH,qBAAa,MAAM;IACjB;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA4B;IACzD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAe;IAE7C;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA0D;IAErF;;OAEG;IACH,OAAO,CAAC,aAAa;IAOrB;;;;;;;;OAQG;IACI,QAAQ,CACb,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,YAAY,EACrB,WAAW,GAAE,UAAU,EAAO,EAC9B,eAAe,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,EACtC,UAAU,CAAC,EAAE,MAAM,GAClB,IAAI;IAgBP;;;;OAIG;IACI,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,GAAE,UAAU,EAAO,GAAG,IAAI;IAIrF;;;;OAIG;IACI,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,GAAE,UAAU,EAAO,GAAG,IAAI;IAItF;;;;OAIG;IACI,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,GAAE,UAAU,EAAO,GAAG,IAAI;IAIrF;;;;OAIG;IACI,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,GAAE,UAAU,EAAO,GAAG,IAAI;IAIxF;;;;OAIG;IACI,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,GAAE,UAAU,EAAO,GAAG,IAAI;IAIvF;;;;;OAKG;IACI,SAAS,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS;IAKrE;;;;;OAKG;IACI,kBAAkB,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,UAAU,CAAA;KAAE,GAAG,SAAS;IAmC5G;;;OAGG;IACU,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBvD;;;;OAIG;IACU,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC;IA4BpE;;;OAGG;IACI,SAAS,IAAI,SAAS,KAAK,EAAE;IAIpC;;OAEG;IACI,KAAK,IAAI,IAAI;CAMrB"}
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/router/router.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAGhD;;;GAGG;AACH,qBAAa,MAAM;IACjB;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA4B;IACzD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAe;IAE7C;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA0D;IAErF;;OAEG;IACH,OAAO,CAAC,aAAa;IAOrB;;;;;;;;OAQG;IACI,QAAQ,CACb,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,YAAY,EACrB,WAAW,GAAE,UAAU,EAAO,EAC9B,eAAe,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,EACtC,UAAU,CAAC,EAAE,MAAM,GAClB,IAAI;IAgBP;;;;OAIG;IACI,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,GAAE,UAAU,EAAO,GAAG,IAAI;IAIrF;;;;OAIG;IACI,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,GAAE,UAAU,EAAO,GAAG,IAAI;IAItF;;;;OAIG;IACI,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,GAAE,UAAU,EAAO,GAAG,IAAI;IAIrF;;;;OAIG;IACI,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,GAAE,UAAU,EAAO,GAAG,IAAI;IAIxF;;;;OAIG;IACI,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,GAAE,UAAU,EAAO,GAAG,IAAI;IAIvF;;;;;OAKG;IACI,SAAS,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS;IAKrE;;;;;OAKG;IACI,kBAAkB,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,UAAU,CAAA;KAAE,GAAG,SAAS;IAmC5G;;;OAGG;IACU,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAgCvD;;;;OAIG;IACU,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC;IAmCpE;;;OAGG;IACI,SAAS,IAAI,SAAS,KAAK,EAAE;IAIpC;;OAEG;IACI,KAAK,IAAI,IAAI;CAMrB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dangao/bun-server",
-  "version": "1.8.2",
+  "version": "1.9.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/src/controller/controller.ts

@@ -15,6 +15,7 @@ import {
   InterceptorChain,
   scanInterceptorMetadata,
 } from '../interceptor';
+import { LoggerManager } from '@dangao/logsmith';
 
 /**
  * 控制器元数据键
@@ -212,6 +213,13 @@ export class ControllerRegistry {
           // 创建响应
           return context.createResponse(responseData);
         } catch (error) {
+          LoggerManager.getLogger().debug('Controller handler error', {
+            controller: controllerClass.name,
+            method: propertyKey,
+            path: context.path,
+            errorMessage: error instanceof Error ? error.message : String(error),
+            stack: error instanceof Error ? error.stack : undefined,
+          });
           // 使用全局错误处理器，确保错误码和国际化正确应用
           const { handleError } = await import('../error/handler');
           return await handleError(error, context);
@@ -258,8 +266,8 @@ export class ControllerRegistry {
       base = '/';
     }
 
-    // 规范化 methodPath：移除前导斜杠
-    const method = methodPath.replace(/^\/+/, '');
+    // 规范化 methodPath：移除前导斜杠（支持 undefined，如 @GET() 无参）
+    const method = (methodPath ?? '').replace(/^\/+/, '');
 
     if (!method) {
       // 如果方法路径为空，返回基础路径

package/src/core/application.ts

@@ -18,6 +18,7 @@ import { ConfigService } from '../config/service';
 import { ConfigModule } from '../config/config-module';
 import { CacheModule, CACHE_POST_PROCESSOR_TOKEN } from '../cache';
 import { LoggerManager } from '@dangao/logsmith';
+import { EventModule } from '../events/event-module';
 
 /**
  * 应用配置选项
@@ -102,6 +103,9 @@ export class Application {
     // 初始化配置中心集成（在所有模块注册完成后）
     await this.initializeConfigCenter();
 
+    // 自动初始化事件监听器（如果 EventModule 已注册且启用了 autoScan）
+    this.initializeEventListeners();
+
     const finalPort = port ?? this.options.port ?? 3000;
     const finalHostname = hostname ?? this.options.hostname;
 
@@ -178,6 +182,31 @@ export class Application {
     }
   }
 
+  /**
+   * 初始化事件监听器
+   * 在所有模块注册完成后调用，自动扫描并注册使用 @OnEvent 装饰器的类
+   */
+  private initializeEventListeners(): void {
+    const container = this.getContainer();
+    
+    // 检查 EventModule 是否已注册
+    const registry = ModuleRegistry.getInstance();
+    const eventModuleRef = registry.getModuleRef(EventModule);
+    
+    if (!eventModuleRef) {
+      // EventModule 未注册，跳过
+      return;
+    }
+
+    // 调用自动初始化
+    const initialized = EventModule.autoInitialize(container);
+    
+    if (initialized) {
+      const logger = LoggerManager.getLogger();
+      logger.debug('[Application] Event listeners initialized automatically');
+    }
+  }
+
   /**
    * 停止应用（立即停止，不等待请求完成）
    */
@@ -242,6 +271,13 @@ export class Application {
    * @returns 响应对象
    */
   private async handleRequest(context: Context): Promise<Response> {
+    const logger = LoggerManager.getLogger();
+    logger.debug('[Request] Incoming', {
+      method: context.method,
+      path: context.path,
+      url: context.url?.href,
+    });
+
     // 使用 AsyncLocalStorage 包裹请求处理，确保所有中间件和控制器都在请求上下文中执行
     return await contextStore.run(context, async () => {
       // 对于 POST、PUT、PATCH 请求，提前解析 body 并缓存
@@ -265,6 +301,10 @@ export class Application {
           return response;
         }
 
+        logger.debug('[Router] No route matched', {
+          method: context.method,
+          path: context.path,
+        });
         context.setStatus(404);
         return context.createResponse({ error: 'Not Found' });
       });

package/src/error/handler.ts

@@ -3,6 +3,7 @@ import { HttpException } from './http-exception';
 import { ExceptionFilterRegistry } from './filter';
 import { ValidationError } from '../validation';
 import { ErrorMessageI18n } from './i18n';
+import { LoggerManager } from '@dangao/logsmith';
 
 /**
  * 全局错误处理
@@ -16,6 +17,15 @@ export async function handleError(error: unknown, context: Context): Promise<Res
 
   if (error instanceof HttpException) {
     context.setStatus(error.status);
+    if (error.status >= 400) {
+      LoggerManager.getLogger().debug('HttpException', {
+        method: context.method,
+        path: context.path,
+        status: error.status,
+        code: error.code,
+        message: error.message,
+      });
+    }
 
     // 如果异常有错误码，尝试国际化消息
     let errorMessage = error.message;
@@ -56,7 +66,14 @@ export async function handleError(error: unknown, context: Context): Promise<Res
   }
 
   const message = error instanceof Error ? error.message : String(error);
+  const stack = error instanceof Error ? error.stack : undefined;
   context.setStatus(500);
+  LoggerManager.getLogger().debug('Internal error (500)', {
+    method: context.method,
+    path: context.path,
+    message,
+    stack,
+  });
   return context.createResponse({
     error: 'Internal Server Error',
     details: process.env.NODE_ENV === 'production' ? undefined : message,

package/src/events/event-module.ts

@@ -102,6 +102,11 @@ export class EventModule {
    */
   private static listenerClasses: Function[] = [];
 
+  /**
+   * 模块选项
+   */
+  private static options: EventModuleOptions & { autoScan?: boolean } = {};
+
   /**
    * 创建事件模块
    * @param options - 模块配置
@@ -121,6 +126,12 @@ export class EventModule {
    * ```
    */
   public static forRoot(options: EventModuleOptions = {}): typeof EventModule {
+    // 保存选项（默认启用自动扫描）
+    EventModule.options = {
+      ...options,
+      autoScan: options.autoScan ?? true,
+    };
+
     const providers: ModuleProvider[] = [];
 
     // 创建事件发射器服务
@@ -269,4 +280,101 @@ export class EventModule {
 
     return undefined;
   }
+
+  /**
+   * 自动初始化事件监听器
+   * 由框架在应用启动时自动调用，扫描所有模块中使用 @OnEvent 装饰器的类并注册
+   * 
+   * @param rootContainer - 根容器
+   * @returns 是否成功初始化
+   * 
+   * @internal 此方法由框架内部调用，用户通常不需要手动调用
+   */
+  public static autoInitialize(rootContainer: Container): boolean {
+    // 检查是否启用自动扫描
+    if (EventModule.options.autoScan === false) {
+      return false;
+    }
+
+    // 获取 EventEmitter
+    const registry = ModuleRegistry.getInstance();
+    const eventModuleRef = registry.getModuleRef(EventModule);
+
+    if (!eventModuleRef) {
+      return false;
+    }
+
+    let eventEmitter: EventEmitter | undefined;
+    try {
+      eventEmitter = eventModuleRef.container.resolve<EventEmitter>(EVENT_EMITTER_TOKEN);
+    } catch {
+      return false;
+    }
+
+    if (!eventEmitter) {
+      return false;
+    }
+
+    // 收集所有监听器类
+    const listenerClasses = new Set<Function>();
+
+    // 1. 添加通过 registerListeners 注册的类
+    for (const listenerClass of EventModule.listenerClasses) {
+      listenerClasses.add(listenerClass);
+    }
+
+    // 2. 添加通过选项配置的强制包含类
+    if (EventModule.options.includeListeners) {
+      for (const listenerClass of EventModule.options.includeListeners) {
+        listenerClasses.add(listenerClass);
+      }
+    }
+
+    // 3. 自动扫描所有模块的 providers，并从对应的模块容器中解析实例
+    const shouldAutoScan = EventModule.options.autoScan ?? true;
+    if (shouldAutoScan === true) {
+      const allModuleRefs = Array.from(registry['moduleRefs'].values());
+      
+      for (const moduleRef of allModuleRefs) {
+        for (const provider of moduleRef.metadata.providers) {
+          // 提取提供者类
+          let providerClass: Function | undefined;
+
+          if (typeof provider === 'function') {
+            providerClass = provider;
+          } else if ('useClass' in provider && provider.useClass) {
+            providerClass = provider.useClass;
+          }
+
+          // 检查是否是事件监听器类
+          if (providerClass && isEventListenerClass(providerClass)) {
+            // 检查是否被排除
+            const isExcluded = EventModule.options.excludeListeners?.includes(providerClass);
+            if (!isExcluded) {
+              // 使用模块容器创建 scanner 并注册监听器
+              // 这样可以确保解析的实例和控制器中注入的是同一个
+              const scanner = new EventListenerScanner(eventEmitter, moduleRef.container);
+              scanner.registerListenerClass(providerClass);
+            }
+          }
+        }
+      }
+    }
+
+    // 4. 注册通过选项配置的强制包含类（使用根容器）
+    if (EventModule.options.includeListeners) {
+      const scanner = new EventListenerScanner(eventEmitter, rootContainer);
+      for (const listenerClass of EventModule.options.includeListeners) {
+        scanner.registerListenerClass(listenerClass);
+      }
+    }
+
+    // 5. 注册通过 registerListeners 注册的类（使用根容器）
+    if (EventModule.listenerClasses.length > 0) {
+      const scanner = new EventListenerScanner(eventEmitter, rootContainer);
+      scanner.scanAndRegister(EventModule.listenerClasses);
+    }
+
+    return true;
+  }
 }

package/src/events/types.ts

@@ -173,6 +173,25 @@ export interface EventModuleOptions {
    * @param payload - 事件负载
    */
   onError?: (error: Error, event: string | symbol, payload: unknown) => void;
+
+  /**
+   * 是否自动扫描和注册事件监听器
+   * 当设置为 true 时，框架会在应用启动时自动扫描所有模块中使用 @OnEvent 装饰器的类
+   * @default true
+   */
+  autoScan?: boolean;
+
+  /**
+   * 需要排除的监听器类（不自动注册）
+   * 用于在自动扫描时排除某些类
+   */
+  excludeListeners?: Function[];
+
+  /**
+   * 额外的监听器类（强制注册）
+   * 即使 autoScan 为 false，这些类也会被注册
+   */
+  includeListeners?: Function[];
 }
 
 /**

package/src/middleware/builtin/error-handler.ts

@@ -41,12 +41,22 @@ export function createErrorHandlingMiddleware(
     try {
       return await next();
     } catch (error) {
+      const routeHandler = (context as { routeHandler?: { controller?: { name?: string }; method?: string } }).routeHandler;
       log(error, { method: context.method, path: context.path });
       logger.error("Unhandled error", {
         method: context.method,
         path: context.path,
         error,
       });
+      logger.debug("Unhandled error details", {
+        method: context.method,
+        path: context.path,
+        routeHandler: routeHandler
+          ? `${routeHandler.controller?.name ?? 'unknown'}.${routeHandler.method ?? 'unknown'}`
+          : undefined,
+        errorMessage: error instanceof Error ? error.message : String(error),
+        stack: error instanceof Error ? error.stack : undefined,
+      });
 
       if (error instanceof Response) {
         return error as Response;

package/src/middleware/builtin/logger.ts

@@ -38,6 +38,14 @@ export function createLoggerMiddleware(
     } finally {
       const status = response?.status ?? context.statusCode ?? 200;
       log(`${prefix} ${context.method} ${context.path} ${status}`);
+      if (status >= 400) {
+        const logger = LoggerManager.getLogger();
+        logger.debug(`${prefix} Error response`, {
+          method: context.method,
+          path: context.path,
+          statusCode: status,
+        });
+      }
     }
   };
 }
@@ -85,6 +93,15 @@ export function createRequestLoggingMiddleware(
         }ms`,
         error instanceof Error ? { error: error.message } : undefined,
       );
+      if (error instanceof Error) {
+        LoggerManager.getLogger().debug(`${prefix} Request error details`, {
+          method: context.method,
+          path: context.path,
+          durationMs: duration.toFixed(2),
+          message: error.message,
+          stack: error.stack,
+        });
+      }
       throw error;
     }
   };

package/src/router/decorators.ts

@@ -25,10 +25,10 @@ export interface RouteMetadata {
 /**
  * 路由装饰器工厂
  * @param method - HTTP 方法
- * @param path - 路由路径
+ * @param path - 路由路径（可选，默认 ''，即 @GET() 等价于根路径）
  * @returns 方法装饰器
  */
-function createRouteDecorator(method: HttpMethod, path: string) {
+function createRouteDecorator(method: HttpMethod, path: string = '') {
   return function (target: any, propertyKey: string | symbol, descriptor: PropertyDescriptor) {
     // 注意：装饰器应用顺序问题
     // 方法装饰器（@GET）在类装饰器（@Controller）之前应用
@@ -72,9 +72,9 @@ function createRouteDecorator(method: HttpMethod, path: string) {
       }
     }
     
-    existingRoutes.push({ 
-      method, 
-      path, 
+    existingRoutes.push({
+      method,
+      path: path ?? '',
       handler: descriptor.value as RouteHandler,
       propertyKey: propertyKeyStr || undefined,
     });
@@ -84,40 +84,40 @@ function createRouteDecorator(method: HttpMethod, path: string) {
 
 /**
  * GET 路由装饰器
- * @param path - 路由路径
+ * @param path - 路由路径（可选，默认 ''，即 @GET() 映射到控制器基础路径或 /）
  */
-export function GET(path: string) {
+export function GET(path: string = '') {
   return createRouteDecorator('GET', path);
 }
 
 /**
  * POST 路由装饰器
- * @param path - 路由路径
+ * @param path - 路由路径（可选，默认 ''）
  */
-export function POST(path: string) {
+export function POST(path: string = '') {
   return createRouteDecorator('POST', path);
 }
 
 /**
  * PUT 路由装饰器
- * @param path - 路由路径
+ * @param path - 路由路径（可选，默认 ''）
  */
-export function PUT(path: string) {
+export function PUT(path: string = '') {
   return createRouteDecorator('PUT', path);
 }
 
 /**
  * DELETE 路由装饰器
- * @param path - 路由路径
+ * @param path - 路由路径（可选，默认 ''）
  */
-export function DELETE(path: string) {
+export function DELETE(path: string = '') {
   return createRouteDecorator('DELETE', path);
 }
 
 /**
  * PATCH 路由装饰器
- * @param path - 路由路径
+ * @param path - 路由路径（可选，默认 ''）
  */
-export function PATCH(path: string) {
+export function PATCH(path: string = '') {
   return createRouteDecorator('PATCH', path);
 }

package/src/router/router.ts

@@ -3,6 +3,7 @@ import type { Constructor } from '../core/types';
 import { Route } from './route';
 import type { HttpMethod, RouteHandler, RouteMatch } from './types';
 import type { Middleware } from '../middleware';
+import { LoggerManager } from '@dangao/logsmith';
 
 /**
  * 路由器类
@@ -168,14 +169,23 @@ export class Router {
   public async preHandle(context: Context): Promise<void> {
     const method = context.method as HttpMethod;
     const path = this.normalizePath(context.path);
+    const logger = LoggerManager.getLogger();
 
     // 使用 findRouteWithMatch 避免重复匹配
     const result = this.findRouteWithMatch(method, path);
     if (!result) {
+      logger.debug('[Router] Route not matched', { method, path });
       return;
     }
 
     const { route, match } = result;
+    logger.debug('[Router] Route matched', {
+      method,
+      path,
+      routePath: route.path,
+      controller: route.controllerClass?.name,
+      methodName: route.methodName,
+    });
     if (match.matched) {
       context.params = match.params;
     }
@@ -196,6 +206,7 @@ export class Router {
   public async handle(context: Context): Promise<Response | undefined> {
     const method = context.method as HttpMethod;
     const path = this.normalizePath(context.path);
+    const logger = LoggerManager.getLogger();
 
     // 使用 findRouteWithMatch 获取路由和匹配结果
     const result = this.findRouteWithMatch(method, path);
@@ -204,7 +215,13 @@ export class Router {
     }
 
     const { route, match } = result;
-    
+
+    logger.debug('[Router] Executing handler', {
+      path: route.path,
+      controller: route.controllerClass?.name,
+      methodName: route.methodName,
+    });
+
     // 设置路径参数
     if (match.matched) {
       context.params = match.params;