本文介绍在严格模式下安全、可靠地获取当前执行函数名的多种方法，包括原生 error.stack 解析优化方案和成熟第三方库 stacktrace-js 的使用技巧，并附带性能对比与最佳实践建议。
本文介绍在严格模式下安全、可靠地获取当前执行函数名的多种方法，包括原生 error.stack 解析优化方案和成熟第三方库 stacktrace-js 的使用技巧，并附带性能对比与最佳实践建议。
在 Node.js 应用中实现统一追踪（tracing）时，为 Span 自动命名是提升可观测性的重要一环。理想情况下，Span 名称应直接对应当前执行函数名（如 getUserById），避免手动传参带来的冗余与错误风险。然而，由于 ES6+ 默认启用严格模式，arguments.callee 和 function.caller 均被禁用，原生 API 并未提供 Function.name 的运行时上下文反射能力——因此必须借助调用栈（stack trace）进行推断。
✅ 推荐方案一：优化版原生 Error.stack 解析（零依赖）
您提供的正则解析方案思路正确，但存在可改进点：
- 使用 stackTrace[2] 依赖固定行号，易受环境（如模块加载器、Babel 插件、Source Map）干扰；
- 正则 /at\s+([\w.]+)\s+/u 无法匹配箭头函数、匿名函数、类方法或带空格的函数引用（如 at Object.myHandler）；
- 未处理 eval、<anonymous>、<unknown> 等边界情况。
以下是健壮性增强的实现：
function getCurrentFunctionName() {
const stack = new Error().stack;
if (!stack) return 'unknown';
// 匹配标准 V8 栈帧格式：'at functionName (file:line:col)' 或 'at Object.functionName (file:line:col)'
const match = stack
.split('\n')[1] // 跳过 Error 构造行，取调用者所在行（更稳定于 [2]）
.match(/at\s+(?:[^(\n]+(?:\s+on\s+)?|.*?\s+)(?:Object\.|exports\.|module\.exports\.)?([a-zA-Z_$][\w$]*)\s*\(?/);
return match && match[1] ? match[1] : 'anonymous';
}
// 示例使用
function fetchData() {
console.log(getCurrentFunctionName()); // 'fetchData'
}
fetchData();⚠️ 注意：该方法在生产环境需谨慎使用——每次调用均触发 Error 实例化与字符串解析，存在性能开销（约 0.1–0.3ms/次）。建议仅用于调试或低频 tracing 场景。
✅ 推荐方案二：使用 stacktrace-js（推荐用于生产 tracing）
stacktrace-js 是经过广泛验证的栈解析库，支持 Source Map、跨平台兼容，并内置健壮的函数名提取逻辑：
npm install stacktrace-js
const { getSync } = require('stacktrace-js');
function createSpan() {
const stack = getSync();
const currentFn = stack[0]?.functionName || 'unknown';
console.log(`Starting span for: ${currentFn}`);
return { name: currentFn };
}
// 测试
function handleRequest() {
const span = createSpan(); // 输出：Starting span for: handleRequest
}
handleRequest();其返回的 stack[0] 即为当前函数调用栈顶帧（即 createSpan 所在位置），functionName 字段已自动归一化处理：
- ✅ 支持命名函数、箭头函数（显示为 undefined，需结合上下文处理）；
- ✅ 兼容类方法（如 MyClass#process）、模块导出函数；
- ✅ 可选集成 stacktrace-gps 进行 Source Map 映射（适合打包后环境）。
? 最佳实践与注意事项
- 不要在热路径中高频调用：无论原生或库方案，栈解析均为同步阻塞操作。高频接口（如每秒万级请求）应改用静态装饰器 + 编译时注入（如 TypeScript 装饰器 + Babel 插件）；
- 匿名函数需降级处理：箭头函数、IIFE 等无名函数将返回 undefined 或 <anonymous>，建议 fallback 到文件名+行号（stack[0].fileName + ':' + stack[0].lineNumber）；
- 严格区分“声明名”与“调用名”：Function.name 返回函数定义时的名称，而栈解析返回的是调用时的绑定名（如 const fn = myFunc; fn() 中解析出 myFunc），二者语义不同；
- TypeScript 用户提示：若使用 --noImplicitAny，需为 stacktrace-js 安装类型声明：npm install -D @types/stacktrace-js。
综上，对于开发期快速验证，可采用优化后的原生方案；对于生产级 tracing 系统，强烈推荐 stacktrace-js ——它以可控的体积（~8KB gzip）换取了稳定性、可维护性与生态兼容性，是目前 Node.js 生态中最成熟的运行时函数名反射方案。
