动态修改 NodeJS 程序中的变量值

V2EX = way to explore

V2EX 是一个关于分享和探索的地方

现在注册

已注册用户请登录

这是一个创建于 3423 天前的主题，其中的信息可能已经有所发展或是发生改变。

如果一个 NodeJS 进程正在运行，有办法修改程序中的变量值么？答案是：通过 V8 的 Debugger 接口可以！本文将详细介绍实现步骤。

启动一个 HTTP Server

用简单的 Hello World 做例子吧，不过略作修改。在 global 下放一个变量 message，然后打印出来：
```
// message content will be modified !
global.message = "hello world!";

var server = require('http').createServer(function (req, res) {
res.end(global.message);
}).listen(8001);

console.log('pid = %d', process.pid);
```

用命令启动 Server，此时，通过用浏览器访问 http://localhost:8001 可以看到网页内容是 hello world!。接下来我们将尝试在不改变代码，不重启进程的情况下把 message 换成 "hello bugs!"。

使 Server 进程进入 Debug 模式

V8 引擎在实现的时候留了 Debugger 接口。通过命令 node --debug-brk=5858 [filename] 可以启动一个脚本，并且立即进入 Debug 模式。

那么如果是已经运行着的 NodeJS 程序，可以进入 Debug 模式吗？也是可以的，在操作系统下给 NodeJS 的进程发一个 SIGUSR1 信号，可以让进程进入 Debug 模式。进入 Debug 模式的进程会在本地启动一个 TCP Server 并且默认监听5858 端口。

此时在另一个命令行窗口执行命令 node debug localhost:5858 就可以连接到 Debugger 调试端口，并且可以使用很多常用的 Debug 命令，比如 c继续执行，s 步入， o步出等。

Debugger 协议

使用node debug hostname:port 命令连接到进程进行 Debug 的方式比较简单，但是要完成一些高级的功能就会处处受限，因为它只封装了 Debugger 协议中 command 的一部分。下面介绍一下这个简单的协议。

Client 和 Server 的通讯是通过 TCP 进行的。 DebugClient 第一次连接到 DebugServer 的时候会拿到一些 Header，比如 Node 版本， V8 版本等。后面紧跟着一个空的消息1

消息1

Type: connect\r\n
V8-Version: 3.28.71.19\r\n
Protocol-Version: 1\r\n
Embedding-Host: node v0.12.4\r\n
Content-Length: 0\r\n
\r\n

消息实体由 Header 和 Body 组成，消息1的 Body 为空，所以 Header 中对应的 Content-Length 为 0。而在下面这个例子里，Body 为一个单行的 JSON 字符串，这是由协议所规定的。

消息2

Content-Length: 46\r\n
\r\n
{"command":"version","type":"request","seq":1}

消息2的类型( type )是request，代表这是 Client 发给 Server 的命令，其他的可能值是 response 和 event分别代表 Server 对 Client 的相应，和 Server 端发生的事件。

消息3

Content-Length: 137\r\n
\r\n
{"seq":1,"request_seq":1,"type":"response","command":"version","success":true,"body":{"V8Version":"3.28.71.19"},"refs":[],"running":true}

消息2是 Client 发送给 Server的，消息3是 Server 对 Client 的相应，那么如何判断消息3是不是消息2的结果呢？可以看到消息2中的 seq 值是1，而消息3中的request_seq值是1。 Debugger 协议正是通过这两个值把异步返回的结果和请求一一对应起来的。

Debugger 协议就是这么的简单。

实例化一个 Debugger Client

了解了 Debugger 协议后，相信好奇心强的程序员已经跃跃欲试自己实现一个了。本着不重复发明轮子的原则开始在网上找实现，找了好久找到这个库 pDebug，可惜这个库已经好久不更新了。后来通过阅读 node-inspector 的源码才发现，其实 NodeJS 自带了一个 Debugger 模块, 相关代码在 _debugger 模块里(源码)，由于模块名是以 _ 开头的，所以网上找不到它的 API，好在代码注释写的非常详细，很快就能上手。

我们需要的正是这个模块下的 Client，而 Client 其实是继承于 Socket 的.
```
var Client = require('_debugger').Client;
var client = new Client();

client.connect(5858);
client.on('ready', function () {
// 连接成功
});
```

通过 Debugger 接口执行命令

接下来我们来看看如何修改这个 global 的变量，代码如下
function modifyTheMessage(newMessage) { var msg = { 'command': 'evaluate', 'arguments': { 'expression': 'global.message="' + newMessage + '"', 'global': true } }; client.req(msg, function (err, body, res) { console.log('modified to %s', newMessage); }); }

client.req方法封装了 type=request 消息类型和seq 自增的逻辑，因此在构造 msg JSON对象的时候不需要指明这两个属性。我们要修改 message 其实就是在 JavaScript 调用的顶层执行 global.message=newMessage