beforeExecute 是任务执行前的线程级上下文快照切入点，用于安全捕获、校验、透传 TraceId；需前置在 Web 入口注入并验证合法性，再在 beforeExecute 中绑定与透传，配合日志和 Span 校验一致性，且须轻量无阻塞。
在自研分布式链路追踪插件中，beforeExecute 是一个关键切入点——它能在任务真正执行前、由工作线程同步调用，天然适配“线程级上下文快照”场景。只要 TraceId 已通过 MDC 或类似机制注入当前线程（如 HTTP 请求入口已解析并写入），你就能在此刻安全捕获、校验、透传或增强该 ID，避免异步任务中因线程切换导致的上下文丢失。
确保 TraceId 已在线程启动时就位
beforeExecute 不负责生成或注入 TraceId，只负责“读取与加固”。所以前置动作必须可靠：
- Web 入口（如 Filter/Interceptor）需在请求到达时解析 Header 中的 traceId（如
X-B3-TraceId或自定义字段），并存入MDC.put("traceId", traceId) - 若使用 OpenTelemetry PHP SDK 类似思路（Context + WeakMap），Java 端可对应使用
ThreadLocal<String>或OpenTelemetry.getGlobalTracer().getCurrentSpan()获取当前 Span 的 traceId - 务必验证 traceId 非空且格式合法（如 32 位 hex 字符），否则 fallback 生成新 traceId 并标记为“降级埋点”
在 beforeExecute 中做三件事：捕获、绑定、透传
继承 ThreadPoolExecutor，重写 beforeExecute(Thread t, Runnable r) 方法：
- 从
MDC.get("traceId")或ThreadLocal取出当前 traceId，存为局部变量 - 调用
TracingUtils.bindToCurrentThread(traceId)（你封装的工具类），确保后续子任务、日志、DB 操作都能继承该上下文 - 若任务是
Runnable包装类（如FutureTask），可尝试将 traceId 注入其闭包或构造参数，为后续执行提供显式依据
配合日志与 Span 生命周期做一致性校验
仅靠 beforeExecute 捕获还不够，要闭环验证是否真正生效：
- 在日志 pattern 中启用
%X{traceId}（Logback）或$${mdc:traceId}（Log4j2），确保异步线程输出的日志带 traceId - 若使用手动 Span（如 OpenTelemetry），在 beforeExecute 中启动子 Span，并设置
parentSpanId为当前 span.id，形成父子关系 - 记录一条 debug 日志：
"[beforeExecute] bound traceId={} to thread={}"，便于排查漏埋点场景
注意异常与性能边界
这个钩子运行在工作线程上，任何阻塞或未捕获异常都会影响任务调度：
- 禁止在 beforeExecute 中做远程调用、IO、复杂计算；只做轻量上下文操作
- 所有外部依赖（如 Redis 校验、权限检查）应提前完成，或改用异步回调+幂等标记方式解耦
- 加 try-catch 包裹核心逻辑，防止 traceId 绑定失败导致整个任务被拒
