排查线程安全问题应以jstack为首选工具定性死锁或锁竞争，辅以vjtools预防代码隐患、checkthread保障线程亲和性，三者分层协作而非替代。

排查线程安全问题，核心是看清“谁在等锁、谁拿着锁、等了多久、锁在哪段代码”。jstack 是最直接、最轻量、线上可随时使用的工具；vjtools 和 CheckThread 属于辅助增强型工具，各有侧重，但都不替代 jstack 的基础定位。

jstack：死锁与锁竞争的首选用具

它是 JDK 自带命令，无需安装，无侵入，能快速输出线程堆栈和锁持有关系。

• 检测死锁：执行 jstack -l ，若存在 Java 级死锁，会明确打印 Found one Java-level deadlock，并列出循环等待链（如 Thread-1 持 lockA 等 lockB，Thread-2 持 lockB 等 lockA）
• 识别锁竞争：关注大量线程处于 BLOCKED 状态，且堆栈中出现 waiting to lock ；若多个线程反复阻塞在同一对象锁或 ReentrantLock 上，即为热点锁
• 实操建议：连续执行 3 次（间隔 5–10 秒），对比是否出现“固定阻塞模式”——这是锁竞争而非瞬时抖动的关键信号

vjtools：面向工程规范的静态+运行时辅助检查

vjtools 是唯品会开源的 Java 工具集，其中 thread-check 模块聚焦线程安全风险预警，不用于实时诊断，而用于预防。

Wjs Uploading Video

将一个或多个视频上传至YouTube。当用户想“上传到YouTube”“发YouTube”“批量上传”“upload to YouTube”“post videos to YouTube”或发布到YouTube时使用此技能。

下载

• 它通过字节码扫描，识别常见反模式：如 synchronized 方法内调用外部可变对象、未加锁访问共享变量、ThreadLocal 使用后未 remove 等
• 对死锁无法直接检测，但能发现“锁顺序不一致”的代码苗头（例如同一类中不同方法以不同顺序获取 lockA / lockB）
• 适合集成进 CI 流程，在上线前拦截潜在并发隐患，属于“左移防御”工具

CheckThread：轻量级运行时断言式检测

CheckThread 是一个小型库，通过注解 + 运行时代理，在关键方法入口自动校验线程归属，适用于明确需要“单线程访问”或“同一线程重入”的场景。

• 典型用途：GUI 组件、状态机、Netty ChannelHandler 等要求严格线程亲和性的模块
• 它不分析锁，也不报告死锁，而是当非预期线程调用被 @ThreadConfined 标记的方法时，抛出异常或记录告警
• 对热点锁竞争无感知，但可配合 jstack 定位到具体是哪个“本该串行执行”的逻辑被并发误触

真正落地的排查路径是：先用 jstack 快速定性（死锁？还是持续 BLOCKED？），再结合业务代码看锁粒度与顺序；有余力时，用 vjtools 扫描历史代码补漏；对强线程约束模块，用 CheckThread 加一道运行时护栏。三者不是并列替代关系，而是分层协作。