如何在Node.js函数应用的独立模块中使用context.log？

方案1：利用Async Local Storage（Node.js原生特性） #

Node.js 14.17+内置了AsyncLocalStorage，可在异步调用链中安全共享context对象，无需手动传递。

• 步骤1：创建全局日志工具模块logger.js：

const { AsyncLocalStorage } = require('async_hooks');

const asyncLocalStorage = new AsyncLocalStorage();

// 绑定当前请求的context到异步上下文
function setContext(context) {
  return asyncLocalStorage.run(new Map(), () => {
    asyncLocalStorage.getStore().set('context', context);
  });
}

// 获取带上下文的日志实例
function getLogger() {
  const store = asyncLocalStorage.getStore();
  if (!store) {
    // 降级处理，仅作为 fallback
    return console;
  }
  const context = store.get('context');
  return context?.log || console;
}

module.exports = { setContext, getLogger };

• 步骤2：在函数入口初始化上下文：

const { setContext } = require('./logger');

module.exports = async function (context, req) {
  // 尽早绑定当前context
  await setContext(context);
  
  // 调用辅助模块
  const helper = require('./helper');
  helper.doBusinessLogic();
  
  context.res = { body: '处理完成' };
};

• 步骤3：在辅助模块中使用全局日志：

const { getLogger } = require('./logger');

function doBusinessLogic() {
  const log = getLogger();
  log.info('辅助模块执行操作，日志将自动携带operation_id');
  log.warn('这是一条警告日志');
}

module.exports = { doBusinessLogic };

此方案完全原生，能保证异步调用链的上下文一致性，日志会自动填充operation_id。

方案2：重写console全局方法（不推荐，仅适用于简单场景） #

若不想使用AsyncLocalStorage，可重写全局console方法，让它在有context时调用context.log，否则使用原生console。但该方案存在全局污染风险，并发场景下可能出现上下文串用问题。

// 在所有模块引入前加载此文件
let currentContext = null;

function setCurrentContext(context) {
  currentContext = context;
}

// 重写console核心方法
const originalLog = console.log;
const originalInfo = console.info;
const originalError = console.error;

console.log = (...args) => currentContext?.log?.(...args) || originalLog(...args);
console.info = (...args) => currentContext?.log?.info?.(...args) || originalInfo(...args);
console.error = (...args) => currentContext?.log?.error?.(...args) || originalError(...args);

module.exports = { setCurrentContext };

在函数入口调用setCurrentContext(context)后，辅助模块直接使用console.log即可，但仅建议在低并发、简单场景下使用。

注意事项 #

• 优先选择AsyncLocalStorage方案，它是Node.js官方为异步上下文共享设计的特性，稳定性和兼容性更优。
• 禁止在全局作用域直接存储context，否则会导致并发请求的上下文串用。
• 务必在函数入口尽早初始化AsyncLocalStorage，避免异步操作后绑定导致日志丢失上下文。

内容的提问来源于stack exchange，提问作者Ivan Wilson