GoFrame 核心組件-調(diào)試命令

基本介紹

?goframe?框架的各個(gè)組件在一些關(guān)鍵的功能節(jié)點(diǎn)會(huì)打印出一些調(diào)試信息，原本僅供框架內(nèi)部開發(fā)者在開發(fā)階段使用。由于功能強(qiáng)大，從?goframe?框架?v1.10.0?版本開始，全面開放給所有的框架使用者。

框架調(diào)試模式下打印的調(diào)試信息將會(huì)以?[INTE]?級(jí)別的日志前綴輸出到終端標(biāo)準(zhǔn)輸出，并且會(huì)打印出所在源文件的名稱以及代碼行號(hào)，例如：

2021-04-14 15:24:52.954 [INTE] gdb_driver_mysql.go:49 Open: root:12345678@tcp(127.0.0.1:3306)/test
2021-04-14 15:24:52.954 [INTE] gdb.go:492 open new connection success, master:false, config:&gdb.ConfigNode{Host:"", Port:"", User:"", Pass:"", Name:"", Type:"mysql", Role:"", Debug:false, Prefix:"", DryRun:false, Weight:0, Charset:"", LinkInfo:"root:12345678@tcp(127.0.0.1:3306)/test", MaxIdleConnCount:0, MaxOpenConnCount:0, MaxConnLifeTime:0, QueryTimeout:0, ExecTimeout:0, TranTimeout:0, PrepareTimeout:0, CreatedAt:"", UpdatedAt:"", DeletedAt:"", TimeMaintainDisabled:false}, node:&gdb.ConfigNode{Host:"", Port:"", User:"", Pass:"", Name:"", Type:"mysql", Role:"", Debug:false, Prefix:"", DryRun:false, Weight:0, Charset:"utf8", LinkInfo:"root:12345678@tcp(127.0.0.1:3306)/test", MaxIdleConnCount:0, MaxOpenConnCount:0, MaxConnLifeTime:0, QueryTimeout:0, ExecTimeout:0, TranTimeout:0, PrepareTimeout:0, CreatedAt:"", UpdatedAt:"", DeletedAt:"", TimeMaintainDisabled:false}

特性開啟

這些調(diào)試信息默認(rèn)情況下是關(guān)閉的，不會(huì)影響框架性能，框架的開發(fā)者和使用者可以通過以下方式打開：

1. 命令行啟動(dòng)參數(shù) - ?gf.debug=true?。
2. 指定的環(huán)境變量 - ?GF_DEBUG=true?。
3. 在?GoFrame v1.14.0?版本以后，在程序啟動(dòng)?boot?包中使用?g.SetDebug?方法手動(dòng)打開/關(guān)閉。該方法是非并發(fā)安全的，意味著您不能在運(yùn)行時(shí)異步多協(xié)程去調(diào)用該方法動(dòng)態(tài)設(shè)置調(diào)試模式。

您可以發(fā)現(xiàn)?goframe?框架的許多功能模塊特性也是按照命令行啟動(dòng)參數(shù)+環(huán)境變量的形式按照一定規(guī)則進(jìn)行配置。

需要注意的是，框架的各個(gè)模塊關(guān)鍵調(diào)試信息僅會(huì)輸出到終端標(biāo)準(zhǔn)輸出，不支持輸出到日志文件中。

使用示例

通過環(huán)境變量啟用調(diào)試模式

我們以Goland IDE為例，在運(yùn)行模板中添加?GF_DEBUG?環(huán)境變量即可。

通過命令行參數(shù)啟用調(diào)試模式

啟動(dòng)程序的時(shí)候帶上?--gf.debug=true?即可，例如：

$ ./app --gf.debug=true

$ ./app --gf.debug true

或者

$ ./app --gf.debug=1

$ ./app --gf.debug 1