首页
学习
活动
专区
工具
TVP
发布
社区首页 >专栏 >解放双手:如何在本地调试远程服务器上的Node代码

解放双手:如何在本地调试远程服务器上的Node代码

作者头像
IMWeb前端团队
发布2017-12-29 18:37:35
2.6K0
发布2017-12-29 18:37:35
举报
文章被收录于专栏:IMWeb前端团队IMWeb前端团队

写在前面

谈到node断点调试,目前主要有三种方式,通过node内置调试工具通过IDE(如vscode)通过node-inspector,三者本质上差不多。本文着重点在于介绍 如何在本地通过node-inspector 调试远程服务器上的node代码

在进入主题之前,首先会对三种调试方式进行入门讲解,方便新手理解后面的内容。至于老司机们,可以直接跳到主题去。

方式一:内置debug功能

进入调试模式(在第1行断点)

node debug app.js
clipboard.png
clipboard.png

进入调试模式(在第n行断点)

比如要在第3行断点。

方式一:通过debugger

clipboard.png
clipboard.png

方式二:通过sb(line)

clipboard.png
clipboard.png

执行下一步

通过next命令。

clipboard.png
clipboard.png

跳到下一个断点

通过cont命令。

clipboard.png
clipboard.png

查看某个变量的值

输入repl命令后,再次输入变量名,就可以看到变量对应的值。如果想继续执行代码,可以按ctrl+c退出。

clipboard.png
clipboard.png

添加/删除watch

  • 通过watch(expr)来添加监视对象。
  • 通过watchers查看当前所有的监视对象。
  • 通过unwatch(expr)来删除监视对象。

添加watch:

clipboard.png
clipboard.png

删除watch:

clipboard.png
clipboard.png

进入/跳出函数(step in、step out)

  • 进入函数:通过step或者s
  • 跳出函数:通过out或者o

示例代码如下,假设代码运行到logger(str);这一行,首先跳进函数内部,再跳出函数。

var nick = 'chyingp';
var country = 'China';

var str = nick + ' live in ' + country;

var logger = function(msg){
    console.log(msg); // 这里
    console.log('这行会跳过'); // 跳过这行
};

logger(str);  // 假设运行到这里,想要进入logger方法

console.log(str);

示例截图如下:

clipboard.png
clipboard.png

多个文件断点

通过setBreakpoint('script.js', 1), sb(...),在某个文件某一行添加断点。反正我是没成功过。。。怎么看都是bug。。。

重新运行

每次都退出然后node debug app.js相当烦。直接用restart

clipboard.png
clipboard.png

远程调试

比如远程机器ip是192.168.1.126,在远程机器上进入调试模式

[root@localhost ex]# node --debug-brk app.js
Debugger listening on port 5858

然后,在本地机器通过node debug 192.168.1.126:5858连接远程机器进行调试。

node debug 192.168.1.126:5858

如下:

?  /tmp node debug 192.168.1.126:5858
connecting to 192.168.1.126:5858 ... ok
break in /tmp/ex/app.js:1
> 1 var Logger = require('./logger');
  2 
  3 Logger.info('hello');
debug> n
break in /tmp/ex/app.js:3
  1 var Logger = require('./logger');
  2 
> 3 Logger.info('hello');
  4 
  5 });

当然,还可以通过pid进行远程调试,这里就不举例。

参考:https://nodejs.org/api/debugger.html#debugger_advanced_usage

方式二:通过IDE(vscode)

首先,在vscode里打开项目

clipboard.png
clipboard.png

然后,添加调试配置。主要需要修改的是可执行文件的路径。

clipboard.png
clipboard.png

点击代码左侧添加断点。

clipboard.png
clipboard.png

开始调试

clipboard.png
clipboard.png

顺利断点,左侧的变量、监视对象,右侧的调试工具栏,用过chrome dev tool的同学应该很熟悉,不赘述。

clipboard.png
clipboard.png

方式三:通过node-inspector

首先,安装node-inspector

npm install -g node-inspector

方式一:通过node-debug启动调试

启动调试,它会自动帮你在浏览器里打开调试界面。

?  debugger git:(master) ? node-debug app.js
Node Inspector v0.12.8
Visit http://127.0.0.1:8080/?port=5858 to start debugging.
Debugging `app.js`

Debugger listening on port 5858

调试界面如下,简直不能更亲切。

clipboard.png
clipboard.png

方式二:更加灵活的方式

步骤1:通过node-inspector启动Node Inspector Server

?  debugger git:(master) ? node-inspector 
Node Inspector v0.12.8
Visit http://127.0.0.1:8080/?port=5858 to start debugging.

步骤2:通过传统方式启动调试。加入--debug-brk,好让代码在第一行断住。

?  debugger git:(master) ? node --debug-brk app.js
Debugger listening on port 5858

步骤3:在浏览器里打开调试UI界面。就是步骤1里打印出来的地址 http://127.0.0.1:8080/?port=5858。成功

clipboard.png
clipboard.png

实现原理

从上面的例子不难猜想到。(不负责任猜想)

  • 通过node --debug-brk启动调试,监听5858端口。
  • node-inspector启动服务,监听8080端口。
  • 在浏览器里访问http://127.0.0.1:8080/?port=5858。可以看到port=5858这个参数。结合之前讲到的node内置远程调试的功能,可以猜想,在返回UI调试界面的同时,服务内部通过5858端口开始了断点调试。

另外,从下面截图可以看出,UI调试工具(其实是个网页)跟 inspector服务 之间通过websocket进行通信。

用户在界面上操作时,比如设置断点,就向 inspector服务 发送一条消息,inspector服务 在内部通过v8调试器来实现代码的断点。

clipboard.png
clipboard.png

可以看到,用到了v8-debug,这个就待深挖了。

clipboard.png
clipboard.png

通过node-inspector调试远程代码

细心的同学可能会发现,node远程调试其实在上面node-inspector章节的讲解里已经覆盖到了。这里还是来个实际的例子。

假设我们的node代码app.js运行在阿里云的服务器上,服务器ip是xxx.xxx.xxx.xxx

首先,服务器上启动node-inspector服务

[root@iZ94wb7tioqZ ~]# node-inspector 
Node Inspector v0.12.8
Visit http://127.0.0.1:8080/?port=5858 to start debugging.

其次,通过--debug-brk参数,进入调试模式

[root@iZ94wb7tioqZ ex]# node --debug-brk app.js
Debugger listening on port 5858

最后,在本地通过ip地址愉快的访问调试界面。是不是很简单捏。

clipboard.png
clipboard.png

常见问题:安全限制

远程调试常见的问题就是请求被拒绝。这是服务器安全策略的限制。遇到这种情况,开放端口就完事了。

clipboard.png
clipboard.png

在我们的云主机上,默认安装了firewall-cmd,可以通过--add-port选项来开放8080端口的开放。如果本机没有安装firewall-cmd,也可以通过iptables来实现同样的功能。

[root@iZ94wb7tioqZ ex]# firewall-cmd --add-port=8080/tcp
success

然后,就可以愉快的远程调试了。

clipboard.png
clipboard.png

相关链接

Node Debugger

How Does a C Debugger Work?

How debuggers work: Part 2 - Breakpoints

本文参与 腾讯云自媒体分享计划,分享自作者个人站点/博客。
如有侵权请联系 cloudcommunity@tencent.com 删除

本文分享自 作者个人站点/博客 前往查看

如有侵权,请联系 cloudcommunity@tencent.com 删除。

本文参与 腾讯云自媒体分享计划  ,欢迎热爱写作的你一起参与!

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • 方式一:内置debug功能
    • 进入调试模式(在第1行断点)
      • 进入调试模式(在第n行断点)
        • 执行下一步
          • 跳到下一个断点
            • 查看某个变量的值
              • 添加/删除watch
                • 进入/跳出函数(step in、step out)
                  • 多个文件断点
                    • 重新运行
                      • 远程调试
                      • 方式二:通过IDE(vscode)
                      • 方式三:通过node-inspector
                        • 方式一:通过node-debug启动调试
                          • 方式二:更加灵活的方式
                            • 实现原理
                            • 通过node-inspector调试远程代码
                              • 常见问题:安全限制
                              • 相关链接
                              相关产品与服务
                              远程调试
                              远程调试(Remote Debugging,RD)在云端为用户提供上千台真实手机/定制机/模拟器设备,快速实现随时随地测试。运用云测技术对测试方式、操作体验进行了优化,具备多样性的测试能力,包括随时截图和记录调试日志,稳定的支持自动化测试, 设备灵活调度,用例高效执行, 快速定位产品功能和兼容性问题。云手机帮助应用、移动游戏快速发现和解决问题,节省百万硬件费用,加速敏捷研发流程。
                              领券
                              问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档