这个翻译StrongLoop / IBM提供.

相对于英文版的文档,本文档可能已过时。要了解最近的更新,请参阅英文版文档

调试 Express

Express 在内部使用调试模块来记录关于路由匹配、使用的中间件函数、应用程序模式以及请求/响应循环流程的信息。

debug 就像是扩充版的 console.log,但是与 console.log 不同,您不必注释掉生产代码中的 debug 日志。缺省情况下,日志记录功能已关闭,可以使用 DEBUG 环境变量有条件地开启日志记录。

要查看 Express 中使用的所有内部日志,在启动应用程序时,请将 DEBUG 环境变量设置为 express:*


$ DEBUG=express:* node index.js

在 Windows 上,使用对应的命令。


> set DEBUG=express:* & node index.js

Express 生成器所生成的缺省应用程序上运行此命令将显示以下输出:


$ DEBUG=express:* node ./bin/www
  express:router:route new / +0ms
  express:router:layer new / +1ms
  express:router:route get / +1ms
  express:router:layer new / +0ms
  express:router:route new / +1ms
  express:router:layer new / +0ms
  express:router:route get / +0ms
  express:router:layer new / +0ms
  express:application compile etag weak +1ms
  express:application compile query parser extended +0ms
  express:application compile trust proxy false +0ms
  express:application booting in development mode +1ms
  express:router use / query +0ms
  express:router:layer new / +0ms
  express:router use / expressInit +0ms
  express:router:layer new / +0ms
  express:router use / favicon +1ms
  express:router:layer new / +0ms
  express:router use / logger +0ms
  express:router:layer new / +0ms
  express:router use / jsonParser +0ms
  express:router:layer new / +1ms
  express:router use / urlencodedParser +0ms
  express:router:layer new / +0ms
  express:router use / cookieParser +0ms
  express:router:layer new / +0ms
  express:router use / stylus +90ms
  express:router:layer new / +0ms
  express:router use / serveStatic +0ms
  express:router:layer new / +0ms
  express:router use / router +0ms
  express:router:layer new / +1ms
  express:router use /users router +0ms
  express:router:layer new /users +0ms
  express:router use / <anonymous> +0ms
  express:router:layer new / +0ms
  express:router use / <anonymous> +0ms
  express:router:layer new / +0ms
  express:router use / <anonymous> +0ms
  express:router:layer new / +0ms

向应用程序发出请求时,可以看到 Express 代码中指定的日志:


  express:router dispatching GET / +4h
  express:router query  : / +2ms
  express:router expressInit  : / +0ms
  express:router favicon  : / +0ms
  express:router logger  : / +1ms
  express:router jsonParser  : / +0ms
  express:router urlencodedParser  : / +1ms
  express:router cookieParser  : / +0ms
  express:router stylus  : / +0ms
  express:router serveStatic  : / +2ms
  express:router router  : / +2ms
  express:router dispatching GET / +1ms
  express:view lookup "index.pug" +338ms
  express:view stat "/projects/example/views/index.pug" +0ms
  express:view render "/projects/example/views/index.pug" +1ms

要仅查看来自路由器实现的日志,请将 DEBUG 的值设置为 express:router。与此类似,要仅查看来自应用程序实现的日志,请将 DEBUG 的值设置为 express:application,以此类推。

express 生成的应用程序

express 命令生成的应用程序还使用 debug 模块,其调试名称空间范围限定为应用程序的名称。

例如,如果您以 $ express sample-app 生成应用程序,那么可以使用以下命令来启用调试语句:


$ DEBUG=sample-app node ./bin/www

可以通过分配逗号分隔的名称列表来指定多个调试名称空间:


$ DEBUG=http,mail,express:* node index.js

有关 debug 的更多信息,请参阅 debug