node.js与ThreadLocal

ThreadLocal变量的说法来自于Java，这是在多线程模型下出现并发问题的一种解决方案。

ThreadLocal变量作为线程内的局部变量，在多线程下可以保持独立，它存在于

线程的生命周期内，可以在线程运行阶段多个模块间共享数据。那么，ThreadLocal变量

又如何与node.js扯上关系呢？

在node.js领域，由于没有线程的概念，所以笔者更愿意称 ThreadLocal为 “AsyncContext Bound”, 实现地址： github

node模型

node的运行模型无需再赘言： “事件循环 + 异步执行”，可是node开发工程师比较感兴趣的点

大多集中在 “编码模式”上，即异步代码同步编写，由此提出了多种解决回调地狱的解决方案：

• yield
• thunk
• promise
• await

可是如果从代码执行流程的微观视角中跳出来，宏观上看待node服务器处理每个HTTP请求，就会

发现这其实是多线程web服务器的另一种体现，虽然设计上并不像多线程模型那么直观。在单核cpu中

每一时刻node服务器只能处理一个请求，可是node在当前请求中执行异步调用时，就会“中断”进入下一个

事件循环处理另一个请求，直到上一个请求的异步任务事件触发执行对应回调，继续执行该请求的后续逻辑。

这在某种程度上类似于CPU的时间片抢占机制，微观上的顺序执行，宏观上却是同步执行。

node在单进程单线程（js执行线程）中“模拟”了常见的多线程处理逻辑，虽然在单个node进程中无法

充分利用CPU的多核及超线程特性，可是却避免了多线程模型下的临界资源同步和线程上下文

切换的问题，同时内存资源开销相对较小，因此在I/O密集型的业务下使用node开发web服务

往往有着意想不到的好处。

可是在node开发中需要追踪每个请求的调用链路，通过获取请求头的traceId字段在每一级

的调用链路中传递该字段，包括“http请求、dubbo调用、dao操作、redis和日志打点”等操作。

这样通过追踪traceId，就可以分析请求所经过的所有中间链路，评估每个环节的时延与瓶颈，

更容易进行性能优化和错误排查。

那么，如何在业务代码中无侵入性的获取到相关的traceId呢？这就引出了本文的ThreadLocal变量。

传统的日志追踪模式

需手动传递traceId给日志中间件：

var koa = require('koa');
var app =  new koa();
var Logger = {
    info(msg,traceId){
        console.log(msg,traceId);
    }
};
let business = async function(ctx){
    let v = await new Promise((res)=>{
        setTimeout(()=>{
            Logger.info('service执行结束',ctx.request.headers['traceId'])
            res(123);
        },1000);
    });
    ctx.body = 'hello world';
    Logger.info('请求返回',ctx.request.headers['traceId'])
};

app.use(async(ctx,next)=>{
    ctx.request.headers['traceId'] = Date.now() + Math.random();
    await next();
});

app.use(async(ctx,next)=>{
    await business(ctx);
});

app.listen(8080);

在business业务处理函数中，在service执行结束和body返回后都进行日志打点，同时手动

传递请求头traceId给日志模块，方便相关系统追踪链路。

目前这样编码无法规范化日志接口，同时也对开发人员造成了很大的困扰。对于业务开发人员他们

理应不关心如何进行链路追踪，而目前的编码则直接侵入了业务代码中，这块功能应该由日志模块

Logger来实现，可是在与请求上下文没有任何联系的Logger模块如何获取每个请求的traceId呢？

这就需要依靠node.js中的ThreadLocal变量。文章开头提到，多线程下ThreadLocal变量是与

每个线程的生命周期对应的，那么如果在node.js的“单线程+异步调用+事件循环”的特性下实现

类似的ThreadLocal变量，不就可以在每个请求的异步回调执行时获取到对应的ThreadLocal变量，

拿到相关的上下文信息吗？

ThreadLocal的node实现

单纯实现web服务器的中间链路请求追踪其实并不复杂，使用全局变量Map并通过每个请求的唯一标识

存储上下文信息，当执行到该请求的下一个异步调用时便通过在全局Map中获取到与该请求绑定的ThreadLocal

变量，不过这是在应用层面的一种投机行为，是与请求紧耦合的简易实现。

最彻底的方案则是在node应用层实现一种栈帧，在该栈帧内重写所有的异步函数，并添加各个

hook在异步函数的各个生命周期执行，实现异步函数执行上下文与栈帧的映射，这便是最为

彻底的ThreadLocal实现，而不是仅仅停留在与HTTP请求的映射过程中。

目前已经有zone.js库实现了node应用层栈帧的可控编码，同时可以在该栈帧存活阶段绑定

相关数据，我们便可以利用这种特性实现类似多线程下的ThreadLocal变量。

我们的目标是实现无侵入的编写包含链路追踪的业务代码，如下所示：

app.use(async(ctx,next)=>{
    let v = await new Promise((res)=>{
        setTimeout(()=>{
            Logger.info('service执行结束')
            res(123);
        },1000);
    });
    ctx.body = 'hello world';
    Logger.info('请求返回')
});

相比较，Logger.info中不需要手动传递traceId变量，由日志模块通过访问ThreadLocal变量获取。

通过zone.js提供的创建Zone（对应于栈帧）功能，我们不仅可以获取当前请求（类似于多线程下的单个线程）的

ThreadLocal变量，还可以获取上一个请求的相关信息。

require('zone.js');
var koa = require('koa');
var app =  new koa();
var Logger = {
    info(msg){
        console.log(msg,Zone.current.get('traceId'));
    }
};

var koaZoneProperties = {
    requestContext: null
};
var koaZone = Zone.current.fork({
    name: 'koa',
    properties: koaZoneProperties
});
let business = async function(ctx){
    let v = await new Promise((res)=>{
        setTimeout(()=>{
            Logger.info('service执行结束')
            res(123);
        },1000);
    });
    ctx.body = 'hello world';
    Logger.info('请求返回')
};
koaZone.run(()=>{
    app.use(async(ctx,next)=>{
        console.log(koaZone.get('requestContext'))
        ctx.request.headers['traceId'] = Date.now();
        await next();
    });

    app.use(async(ctx,next)=>{
        await new Promise((resolve)=>{
            let koaMidZone = koaZone.fork({
                name: 'koaMidware',
                properties: {
                    traceId: ctx.request.headers['traceId']
                }
            }).run(async()=>{
                // 保存请求上下文至parent zone
                koaZoneProperties.requestContext = ctx;
                await business(ctx);
                resolve();
            });
        });
    });

    app.listen(8080);
});

创建了两个有继承关系的zone（栈帧），koaZone的requestContext属性存储上一个请求的上下文信息；

koaMidZone的traceId属性存储traceId变量，这是一个ThreadLocal变量。

Logger.info中通过Zone.current.get('traceId') 获取当前“线程”的

ThreadLocal变量，无需开发人员手动传递traceId变量。

关于zone.js的其他用法，读者有兴趣可以自行研究。本文主要利用zone.js保存一个执行栈帧

内的多个异步函数的执行上下文与特定数据（即ThreadLocal变量）的映射。

说明

目前，这套模型已在线上业务中用来追踪各级链路，各级中间件包括dubbo client、dubbo provider、

配置中心等都依赖ThreadLocal变量实现数据透传和调用传递，因此可以放心使用。