调试

    对于熟悉用 Visual Studio 和 Eclipse 这些强大的集成开发环境的来做 C++ 和 Java 的同学来说,OpenResty 的 debug 要原始很多,但是对于习惯 Python 开发的同学来说,又是那么的熟悉。 张银奎有本 《软件调试》 的书,Windows 客户端程序猿应该都看过,大家可以去试读下,看看里面有多复杂:(

    对于 OpenResty,坏消息是,没有单步调试这些玩意儿(我们尝试搞出来过 ngx Lua 的单步调试,但是没人用。..); 好消息是,它像 Python 一样,非常简单,不用复杂的技术,只靠 print 和 log 就能定位绝大部分问题,难题有 这个神器。

    在调试的时候最好关闭 这个选项。

    当然,由于每个请求运行在独立的 Lua VM 里,lua_code_cache off 会带来以下几个问题:

    • 2、跟请求无关的模块,由于不会被新的请求加载,并不会主动更新。比如 init_by_lua_file 引用的文件就不会被更新。
    • 3、*_by_lua_block 里面的代码,由于不在 Lua 文件里面,设置 对其没有意义。

    如果调试的目标涉及以上内容,仍需设置 lua_code_cache on,通过 reload 来更新代码。

    记录日志

    这个看上去谁都会的东西,要想做好也不容易。

    如果产品已经发布到用户那里了呢?如果用户那里是隔离网,不能远程怎么办?

    你在写代码的时候,就需要考虑到调试日志。 比如这个代码:

    1. if response then
    2. put_job(client_mid, result)
    3. end

    我们在做一个操作后,就把结果记录到 Nginx 的 error.log 里面,等级是 warn。在生产环境下,日志等级默认为 error,在我们需要详细日志的时候,把等级调整为 即可。在我们的实际使用中,我们会把一些很少发生的重要事件,作为 error 级别记录下来,即使它并不是 Nginx 的错误。