@dangao/bun-server 1.8.2 → 1.8.3

package/dist/controller/controller.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../../src/controller/controller.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAS5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAQhD;;GAEG;AACH,eAAO,MAAM,uBAAuB,eAAuB,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;CAC9B;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,GAAE,MAAW,IACzB,QAAQ,WAAW,CAAC,OAAO,CAAC,UAI9C;AAED;;;GAGG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA4C;IACxE,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAA8C;IAEnF,OAAO;IAIP;;OAEG;WACW,WAAW,IAAI,kBAAkB;IAO/C;;;OAGG;IACI,QAAQ,CAAC,eAAe,EAAE,WAAW,CAAC,OAAO,CAAC,EAAE,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI;IAyJnF;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,YAAY;IA+BpB;;;OAGG;IACI,YAAY,IAAI,SAAS;IAIhC;;;OAGG;IACI,iBAAiB,IAAI,WAAW,CAAC,OAAO,CAAC,EAAE;IAIlD;;;OAGG;IACI,wBAAwB,IAAI,WAAW,CAAC,OAAO,CAAC,EAAE;IAIzD;;OAEG;IACI,KAAK,IAAI,IAAI;CAKrB"}
+{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../../src/controller/controller.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAS5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAShD;;GAEG;AACH,eAAO,MAAM,uBAAuB,eAAuB,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;CAC9B;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,GAAE,MAAW,IACzB,QAAQ,WAAW,CAAC,OAAO,CAAC,UAI9C;AAED;;;GAGG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA4C;IACxE,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAA8C;IAEnF,OAAO;IAIP;;OAEG;WACW,WAAW,IAAI,kBAAkB;IAO/C;;;OAGG;IACI,QAAQ,CAAC,eAAe,EAAE,WAAW,CAAC,OAAO,CAAC,EAAE,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI;IAgKnF;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,YAAY;IA+BpB;;;OAGG;IACI,YAAY,IAAI,SAAS;IAIhC;;;OAGG;IACI,iBAAiB,IAAI,WAAW,CAAC,OAAO,CAAC,EAAE;IAIlD;;;OAGG;IACI,wBAAwB,IAAI,WAAW,CAAC,OAAO,CAAC,EAAE;IAIzD;;OAEG;IACI,KAAK,IAAI,IAAI;CAKrB"}

package/dist/core/application.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"application.d.ts","sourceRoot":"","sources":["../../src/core/application.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAsB,MAAM,UAAU,CAAC;AAMzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAGhD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAGhE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAQ3C;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,uBAAuB,CAAC,EAAE,MAAM,CAAC;IAEjC;;;OAGG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED;;;GAGG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAC,CAAY;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAqB;IACxD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA2B;IAC7D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA8B;IACzD,OAAO,CAAC,uBAAuB,CAAkB;gBAE9B,OAAO,GAAE,kBAAuB;IAsBnD;;;OAGG;IACI,GAAG,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI;IAIxC;;OAEG;IACU,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkCpE;;OAEG;YACW,oBAAoB;IAqBlC;;;OAGG;YACW,sBAAsB;IAyBpC;;OAEG;IACU,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAYlC;;;;;OAKG;IACU,gBAAgB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB9D;;OAEG;YACW,eAAe;IAkB7B;;;;OAIG;YACW,aAAa;IA8B3B;;;OAGG;IACI,kBAAkB,CAAC,eAAe,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,IAAI;IAKtE;;;OAGG;IACI,cAAc,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI;IAqBrD;;;OAGG;IACH,OAAO,CAAC,kCAAkC;IAc1C;;;OAGG;IACI,wBAAwB,CAAC,YAAY,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,IAAI;IAIzE;;;OAGG;IACI,iBAAiB,CAAC,SAAS,EAAE,oBAAoB,GAAG,IAAI;IAK/D;;;OAGG;IACI,SAAS,IAAI,SAAS,GAAG,SAAS;IAIzC;;;OAGG;YACW,gBAAgB;IAsB9B;;;OAGG;YACW,kBAAkB;IAwBhC;;;OAGG;IACI,YAAY;IAInB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA2B7B;;OAEG;IACH,OAAO,CAAC,oBAAoB;CAS7B"}
+{"version":3,"file":"application.d.ts","sourceRoot":"","sources":["../../src/core/application.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAsB,MAAM,UAAU,CAAC;AAMzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAGhD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAGhE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAQ3C;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,uBAAuB,CAAC,EAAE,MAAM,CAAC;IAEjC;;;OAGG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED;;;GAGG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAC,CAAY;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAqB;IACxD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA2B;IAC7D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA8B;IACzD,OAAO,CAAC,uBAAuB,CAAkB;gBAE9B,OAAO,GAAE,kBAAuB;IAsBnD;;;OAGG;IACI,GAAG,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI;IAIxC;;OAEG;IACU,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkCpE;;OAEG;YACW,oBAAoB;IAqBlC;;;OAGG;YACW,sBAAsB;IAyBpC;;OAEG;IACU,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAYlC;;;;;OAKG;IACU,gBAAgB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB9D;;OAEG;YACW,eAAe;IAkB7B;;;;OAIG;YACW,aAAa;IAyC3B;;;OAGG;IACI,kBAAkB,CAAC,eAAe,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,IAAI;IAKtE;;;OAGG;IACI,cAAc,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI;IAqBrD;;;OAGG;IACH,OAAO,CAAC,kCAAkC;IAc1C;;;OAGG;IACI,wBAAwB,CAAC,YAAY,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,IAAI;IAIzE;;;OAGG;IACI,iBAAiB,CAAC,SAAS,EAAE,oBAAoB,GAAG,IAAI;IAK/D;;;OAGG;IACI,SAAS,IAAI,SAAS,GAAG,SAAS;IAIzC;;;OAGG;YACW,gBAAgB;IAsB9B;;;OAGG;YACW,kBAAkB;IAwBhC;;;OAGG;IACI,YAAY;IAInB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA2B7B;;OAEG;IACH,OAAO,CAAC,oBAAoB;CAS7B"}

package/dist/error/handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../src/error/handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAM/C;;GAEG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAsDrF"}
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../src/error/handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAO/C;;GAEG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAsErF"}

package/dist/index.js

@@ -331,6 +331,8 @@ class Route {
 var init_route = () => {};
 
 // src/router/router.ts
+import { LoggerManager as LoggerManager3 } from "@dangao/logsmith";
+
 class Router {
   routes = [];
   staticRoutes = new Map;
@@ -400,11 +402,20 @@ class Router {
   async preHandle(context) {
     const method = context.method;
     const path = this.normalizePath(context.path);
+    const logger = LoggerManager3.getLogger();
     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;
     }
@@ -418,11 +429,17 @@ class Router {
   async handle(context) {
     const method = context.method;
     const path = this.normalizePath(context.path);
+    const logger = LoggerManager3.getLogger();
     const result = this.findRouteWithMatch(method, path);
     if (!result) {
       return;
     }
     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;
     }
@@ -503,7 +520,7 @@ var init_types = __esm(() => {
 
 // src/di/container.ts
 import"reflect-metadata";
-import { LoggerManager as LoggerManager3 } from "@dangao/logsmith";
+import { LoggerManager as LoggerManager4 } from "@dangao/logsmith";
 
 class Container {
   parent;
@@ -621,7 +638,7 @@ class Container {
   resolveInternal(token) {
     const tokenType = typeof token;
     const tokenString = String(token);
-    const logger = LoggerManager3.getLogger();
+    const logger = LoggerManager4.getLogger();
     if (tokenString.includes("Level2") || tokenString.includes("Dependency") || tokenString.includes("Service")) {
       logger.debug(`[DI Debug] resolveInternal: token=${tokenString}, tokenType=${tokenType}`);
     }
@@ -1121,7 +1138,7 @@ var init_param_binder = __esm(() => {
 
 // src/router/decorators.ts
 import"reflect-metadata";
-function createRouteDecorator(method, path) {
+function createRouteDecorator(method, path = "") {
   return function(target, propertyKey, descriptor) {
     const constructor = target.constructor;
     if (constructor && typeof constructor === "function") {
@@ -1147,26 +1164,26 @@ function createRouteDecorator(method, path) {
     }
     existingRoutes.push({
       method,
-      path,
+      path: path ?? "",
       handler: descriptor.value,
       propertyKey: propertyKeyStr || undefined
     });
     Reflect.defineMetadata(ROUTE_METADATA_KEY, existingRoutes, target);
   };
 }
-function GET(path) {
+function GET(path = "") {
   return createRouteDecorator("GET", path);
 }
-function POST(path) {
+function POST(path = "") {
   return createRouteDecorator("POST", path);
 }
-function PUT(path) {
+function PUT(path = "") {
   return createRouteDecorator("PUT", path);
 }
-function DELETE(path) {
+function DELETE(path = "") {
   return createRouteDecorator("DELETE", path);
 }
-function PATCH(path) {
+function PATCH(path = "") {
   return createRouteDecorator("PATCH", path);
 }
 var ROUTE_METADATA_KEY;
@@ -1330,10 +1347,10 @@ var init_decorators4 = __esm(() => {
 });
 
 // src/middleware/builtin/logger.ts
-import { LoggerManager as LoggerManager4 } from "@dangao/logsmith";
+import { LoggerManager as LoggerManager5 } from "@dangao/logsmith";
 function createLoggerMiddleware(options = {}) {
   const log = options.logger ?? ((message, details) => {
-    const logger = LoggerManager4.getLogger();
+    const logger = LoggerManager5.getLogger();
     if (details) {
       logger.info(message, details);
     } else {
@@ -1349,12 +1366,20 @@ function createLoggerMiddleware(options = {}) {
     } finally {
       const status = response?.status ?? context.statusCode ?? 200;
       log(`${prefix} ${context.method} ${context.path} ${status}`);
+      if (status >= 400) {
+        const logger = LoggerManager5.getLogger();
+        logger.debug(`${prefix} Error response`, {
+          method: context.method,
+          path: context.path,
+          statusCode: status
+        });
+      }
     }
   };
 }
 function createRequestLoggingMiddleware(options = {}) {
   const log = options.logger ?? ((message, details) => {
-    const logger = LoggerManager4.getLogger();
+    const logger = LoggerManager5.getLogger();
     logger.info(message, details);
   });
   const prefix = options.prefix ?? "[Request]";
@@ -1372,6 +1397,15 @@ function createRequestLoggingMiddleware(options = {}) {
     } catch (error) {
       const duration = performance.now() - start;
       log(`${prefix} ${context.method} ${context.path} error ${duration.toFixed(2)}ms`, error instanceof Error ? { error: error.message } : undefined);
+      if (error instanceof Error) {
+        LoggerManager5.getLogger().debug(`${prefix} Request error details`, {
+          method: context.method,
+          path: context.path,
+          durationMs: duration.toFixed(2),
+          message: error.message,
+          stack: error.stack
+        });
+      }
       throw error;
     }
   };
@@ -2449,6 +2483,7 @@ var exports_handler = {};
 __export(exports_handler, {
   handleError: () => handleError
 });
+import { LoggerManager as LoggerManager6 } from "@dangao/logsmith";
 async function handleError(error, context) {
   const registry = ExceptionFilterRegistry.getInstance();
   const filterResponse = await registry.execute(error, context);
@@ -2457,6 +2492,15 @@ async function handleError(error, context) {
   }
   if (error instanceof HttpException) {
     context.setStatus(error.status);
+    if (error.status >= 400) {
+      LoggerManager6.getLogger().debug("HttpException", {
+        method: context.method,
+        path: context.path,
+        status: error.status,
+        code: error.code,
+        message: error.message
+      });
+    }
     let errorMessage = error.message;
     if (error.code) {
       const acceptLanguage = context.getHeader("accept-language");
@@ -2483,7 +2527,14 @@ async function handleError(error, context) {
     });
   }
   const message = error instanceof Error ? error.message : String(error);
+  const stack = error instanceof Error ? error.stack : undefined;
   context.setStatus(500);
+  LoggerManager6.getLogger().debug("Internal error (500)", {
+    method: context.method,
+    path: context.path,
+    message,
+    stack
+  });
   return context.createResponse({
     error: "Internal Server Error",
     details: message
@@ -2504,24 +2555,32 @@ var init_error = __esm(() => {
 });
 
 // src/middleware/builtin/error-handler.ts
-import { LoggerManager as LoggerManager5 } from "@dangao/logsmith";
+import { LoggerManager as LoggerManager7 } from "@dangao/logsmith";
 function createErrorHandlingMiddleware(options = {}) {
   const log = options.logger ?? ((error, context) => {
-    LoggerManager5.getLogger().error("[Error]", { ...context, error });
+    LoggerManager7.getLogger().error("[Error]", { ...context, error });
   });
   const expose = options.exposeError ?? false;
   const defaultStatus = options.statusCode ?? 500;
   return async (context, next) => {
-    const logger = LoggerManager5.getLogger();
+    const logger = LoggerManager7.getLogger();
     try {
       return await next();
     } catch (error) {
+      const routeHandler = context.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;
       }
@@ -3028,7 +3087,7 @@ var init_permission_interceptor = __esm(() => {
 
 // src/extensions/logger-extension.ts
 import {
-  LoggerManager as LoggerManager6,
+  LoggerManager as LoggerManager8,
   LogLevel,
   SimpleLogger
 } from "@dangao/logsmith";
@@ -3043,7 +3102,7 @@ class LoggerExtension {
   }
   register(container) {
     const logger = new SimpleLogger(this.options);
-    LoggerManager6.setLogger(logger);
+    LoggerManager8.setLogger(logger);
     container.registerInstance(SimpleLogger, logger);
     container.registerInstance(LOGGER_TOKEN, logger);
   }
@@ -3113,7 +3172,7 @@ var init_logger_module = __esm(() => {
 });
 
 // src/extensions/index.ts
-import { LoggerManager as LoggerManager7, LogLevel as LogLevel2, SimpleLogger as SimpleLogger2 } from "@dangao/logsmith";
+import { LoggerManager as LoggerManager9, LogLevel as LogLevel2, SimpleLogger as SimpleLogger2 } from "@dangao/logsmith";
 var init_extensions = __esm(() => {
   init_logger_extension();
   init_logger_module();
@@ -3230,6 +3289,7 @@ __export(exports_controller, {
   CONTROLLER_METADATA_KEY: () => CONTROLLER_METADATA_KEY
 });
 import"reflect-metadata";
+import { LoggerManager as LoggerManager10 } from "@dangao/logsmith";
 function Controller(path = "") {
   return function(target) {
     Reflect.defineMetadata(CONTROLLER_METADATA_KEY, { path, target }, target);
@@ -3327,6 +3387,13 @@ class ControllerRegistry {
           }
           return context.createResponse(responseData);
         } catch (error) {
+          LoggerManager10.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: handleError2 } = await Promise.resolve().then(() => (init_handler(), exports_handler));
           return await handleError2(error, context);
         }
@@ -3343,7 +3410,7 @@ class ControllerRegistry {
     if (!base) {
       base = "/";
     }
-    const method = methodPath.replace(/^\/+/, "");
+    const method = (methodPath ?? "").replace(/^\/+/, "");
     if (!method) {
       return base === "/" ? "/" : base;
     }
@@ -5338,7 +5405,7 @@ CacheModule = __legacyDecorateClassTS([
   })
 ], CacheModule);
 // src/core/application.ts
-import { LoggerManager as LoggerManager8 } from "@dangao/logsmith";
+import { LoggerManager as LoggerManager11 } from "@dangao/logsmith";
 
 class Application {
   server;
@@ -5433,6 +5500,12 @@ class Application {
     }
   }
   async handleRequest(context) {
+    const logger = LoggerManager11.getLogger();
+    logger.debug("[Request] Incoming", {
+      method: context.method,
+      path: context.path,
+      url: context.url?.href
+    });
     return await contextStore.run(context, async () => {
       if (["POST", "PUT", "PATCH"].includes(context.method)) {
         await context.getBody();
@@ -5445,6 +5518,10 @@ class Application {
         if (response) {
           return response;
         }
+        logger.debug("[Router] No route matched", {
+          method: context.method,
+          path: context.path
+        });
         context.setStatus(404);
         return context.createResponse({ error: "Not Found" });
       });
@@ -5524,7 +5601,7 @@ class Application {
     if (this.signalHandlersInstalled) {
       return;
     }
-    const logger = LoggerManager8.getLogger();
+    const logger = LoggerManager11.getLogger();
     const shutdownHandler = async (signal) => {
       logger.info(`Received ${signal}, starting graceful shutdown...`);
       try {

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.8.3",
   "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

@@ -242,6 +242,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 +272,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/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;

package/tests/controller/path-combination.test.ts

@@ -483,6 +483,141 @@ describe('Controller Path Normalization', () => {
     expect(data.success).toBe(true);
   });
 
+  // 场景 a: @Controller() + @GET('test') / @POST('test') -> /test
+  test('scenario a: @Controller() with @GET("test") and @POST("test") should match /test', async () => {
+    @Controller()
+    class TestController {
+      @GET('test')
+      public getTest() {
+        return { method: 'GET', path: 'test' };
+      }
+
+      @POST('test')
+      public postTest() {
+        return { method: 'POST', path: 'test' };
+      }
+    }
+
+    app.registerController(TestController);
+    await app.listen();
+
+    const getRes = await fetch(`http://localhost:${port}/test`);
+    expect(getRes.status).toBe(200);
+    expect((await getRes.json()).method).toBe('GET');
+
+    const postRes = await fetch(`http://localhost:${port}/test`, { method: 'POST' });
+    expect(postRes.status).toBe(200);
+    expect((await postRes.json()).method).toBe('POST');
+  });
+
+  // 场景 b: @Controller() + @GET('/test') / @POST('/test') -> /test
+  test('scenario b: @Controller() with @GET("/test") and @POST("/test") should match /test', async () => {
+    @Controller()
+    class TestController {
+      @GET('/test')
+      public getTest() {
+        return { method: 'GET', path: 'test' };
+      }
+
+      @POST('/test')
+      public postTest() {
+        return { method: 'POST', path: 'test' };
+      }
+    }
+
+    app.registerController(TestController);
+    await app.listen();
+
+    const getRes = await fetch(`http://localhost:${port}/test`);
+    expect(getRes.status).toBe(200);
+    expect((await getRes.json()).method).toBe('GET');
+
+    const postRes = await fetch(`http://localhost:${port}/test`, { method: 'POST' });
+    expect(postRes.status).toBe(200);
+    expect((await postRes.json()).method).toBe('POST');
+  });
+
+  // 场景 c: @Controller('') + @GET() / @POST() -> /
+  test('scenario c: @Controller("") with @GET() and @POST() should match /', async () => {
+    @Controller('')
+    class TestController {
+      @GET()
+      public getRoot() {
+        return { method: 'GET', path: '/' };
+      }
+
+      @POST()
+      public postRoot() {
+        return { method: 'POST', path: '/' };
+      }
+    }
+
+    app.registerController(TestController);
+    await app.listen();
+
+    const getRes = await fetch(`http://localhost:${port}/`);
+    expect(getRes.status).toBe(200);
+    expect((await getRes.json()).method).toBe('GET');
+
+    const postRes = await fetch(`http://localhost:${port}/`, { method: 'POST' });
+    expect(postRes.status).toBe(200);
+    expect((await postRes.json()).method).toBe('POST');
+  });
+
+  // 场景 d: @Controller() + @GET() / @POST() -> /
+  test('scenario d: @Controller() with @GET() and @POST() should match /', async () => {
+    @Controller()
+    class TestController {
+      @GET()
+      public getRoot() {
+        return { method: 'GET', path: '/' };
+      }
+
+      @POST()
+      public postRoot() {
+        return { method: 'POST', path: '/' };
+      }
+    }
+
+    app.registerController(TestController);
+    await app.listen();
+
+    const getRes = await fetch(`http://localhost:${port}/`);
+    expect(getRes.status).toBe(200);
+    expect((await getRes.json()).method).toBe('GET');
+
+    const postRes = await fetch(`http://localhost:${port}/`, { method: 'POST' });
+    expect(postRes.status).toBe(200);
+    expect((await postRes.json()).method).toBe('POST');
+  });
+
+  // 场景 e: @Controller() + @GET('/') / @POST('/') -> /
+  test('scenario e: @Controller() with @GET("/") and @POST("/") should match /', async () => {
+    @Controller()
+    class TestController {
+      @GET('/')
+      public getRoot() {
+        return { method: 'GET', path: '/' };
+      }
+
+      @POST('/')
+      public postRoot() {
+        return { method: 'POST', path: '/' };
+      }
+    }
+
+    app.registerController(TestController);
+    await app.listen();
+
+    const getRes = await fetch(`http://localhost:${port}/`);
+    expect(getRes.status).toBe(200);
+    expect((await getRes.json()).method).toBe('GET');
+
+    const postRes = await fetch(`http://localhost:${port}/`, { method: 'POST' });
+    expect(postRes.status).toBe(200);
+    expect((await postRes.json()).method).toBe('POST');
+  });
+
   // 测试所有场景在同一应用中同时工作
   test('should handle all path normalization scenarios simultaneously', async () => {
     @Controller('/')