调试Express
Express在内部使用debug模块来记录有关路由匹配、正在使用的中间件函数、应用程序模式以及请求—响应周期流的信息。
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
模块,其debug的命名空间的范围限定为应用程序的名称。
例如,如果你使用$ express sample-app
生成应用程序,则可以使用以下命令启用调试语句:
$ DEBUG=sample-app:* node ./bin/www
你可以通过分配以逗号分隔的名称列表来指定多个调试命名空间:
$ DEBUG=http,mail,express:* node index.js
有关调试的更多信息,请参阅debug。