Java 报错合集

Java VerifyError 与 ClassFormatError 的区别

启动报 VerifyError 或 ClassFormatError，多因字节码增强库、依赖冲突或 Lombok 与 JDK 不兼容。

类加载与依赖

4 篇

类加载、NoSuchMethod、jar 冲突、Native 库加载

Java NoSuchMethodError 依赖版本冲突的定位

编译能过、运行却抛 NoSuchMethodError，九成是编译期与运行期的依赖版本不一致。

Java UnsatisfiedLinkError 加载 Native 库失败

System.loadLibrary 报 UnsatisfiedLinkError，多是库不在 java.library.path、库名或架构不匹配。

ClassNotFoundException 与 NoClassDefFoundError 的区别

ClassNotFoundException 多因 classpath 缺依赖；NoClassDefFoundError 常因静态初始化失败。

2026-08-27

Java OutOfMemoryError: Metaspace 排查与修复

Metaspace 存类元数据且走本地内存，报错多是动态生成类过多或 ClassLoader 泄漏、旧类卸载不掉。

2026-08-27

内存与 GC

6 篇

OOM、GC 调优、内存泄漏、栈溢出

Java OutOfMemoryError Direct buffer memory 排查

堆还没满就 OOM，因为直接内存不在堆里、GC 管不到，多是 Netty 等 NIO 缓冲没释放或没设上限。

Java OutOfMemoryError GC overhead limit exceeded

不是堆真不够，而是 GC 花了超 98% 的时间却只回收不到 2%，根子还是堆小或存在泄漏。

Java OutOfMemoryError: Metaspace 排查与修复

Metaspace 存类元数据且走本地内存，报错多是动态生成类过多或 ClassLoader 泄漏、旧类卸载不掉。

2026-08-27

Java OutOfMemoryError: Java heap space 排查与修复

堆被对象占满、GC 回收不回空间时抛出，用 -XX:+HeapDumpOnOutOfMemoryError 留快照，调大 -Xmx 只是治标。

Java StackOverflowError 栈溢出的定位与解决

不是堆内存不够，是递归或调用链太深把线程栈顶穿；先查递归出口，-Xss 调大只是应急。

Java ThreadLocal 未 remove 导致 OutOfMemoryError

ThreadLocal 在线程池里用完不 remove 会累积无主 value，最终把堆吃满抛出 OutOfMemoryError。

并发与线程

5 篇

死锁、线程安全、并发集合、线程池

SimpleDateFormat 多线程报 NumberFormatException

SimpleDateFormat 内部共享 Calendar，定义成静态变量后并发会报 NumberFormatException 或日期串台。

Java ConcurrentModificationException 单线程也会触发

它不只在多线程出现，单线程遍历时直接增删元素一样触发；改用 removeIf 或 Iterator.remove 即可。

Java 死锁排查 jstack 报 Found one Java-level deadlock

死锁不是异常，是线程各握对方要的锁互相永久等待；用 jstack 能直接打出环上线程。

Java ThreadLocal 未 remove 导致 OutOfMemoryError

ThreadLocal 在线程池里用完不 remove 会累积无主 value，最终把堆吃满抛出 OutOfMemoryError。

Java OOM unable to create new native thread

不是堆满，是操作系统拒绝再创建线程：ulimit -u 或 kernel.threads-max 到顶，或线程栈吃光 native 内存。

异常与反射

2 篇

NPE、InvocationTarget、反射

Java InvocationTargetException 真因在 getCause 里

反射调用 Method.invoke 报 InvocationTargetException 时，真正的异常藏在 getCause 里。

Java 14 NPE 自带变量名，生产环境退化成 <local1>

Java 14 起 NPE 会直接打印为 null 的变量名；前提是打包保留 LocalVariableTable 调试信息。

2026-08-26

I/O 与序列化

2 篇

文件/Socket、NIO、编码、序列化

Java Connection reset 与 Broken pipe 排查

偶发 Connection reset 或 Broken pipe 多是 keep-alive 超时不匹配：客户端还留着对端已关闭的连接。

Java Too many open files 文件描述符耗尽

报 IOException: Too many open files 是 Linux 文件描述符上限被击穿，多半是 FD 泄漏或 ulimit 没生效。

集合与基础 API

2 篇

集合遍历、BigDecimal、日期时间、Stream

BigDecimal 除法报 Non-terminating decimal expansion

BigDecimal 除法没传 scale 和 RoundingMode，遇到无限小数就抛 ArithmeticException。

Java ConcurrentModificationException 单线程也会触发

它不只在多线程出现，单线程遍历时直接增删元素一样触发；改用 removeIf 或 Iterator.remove 即可。

Native 与 JVM

3 篇

JNI、java.library.path、JVM 参数、ulimit

Java Too many open files 文件描述符耗尽

报 IOException: Too many open files 是 Linux 文件描述符上限被击穿，多半是 FD 泄漏或 ulimit 没生效。

Java UnsatisfiedLinkError 加载 Native 库失败

System.loadLibrary 报 UnsatisfiedLinkError，多是库不在 java.library.path、库名或架构不匹配。

Java OOM unable to create new native thread

不是堆满，是操作系统拒绝再创建线程：ulimit -u 或 kernel.threads-max 到顶，或线程栈吃光 native 内存。