Java 开发中常见的误导性错误及排查指南

• 你以为是：数据库不支持事务，或者 Spring 配置失效。
• 实际可能是：
  • 同类调用 (Self-invocation)：你在 ServiceA 的方法 a() 中调用了同类中的 @Transactional 方法 b()。因为 Spring 事务是基于 AOP 动态代理 实现的，同类调用通过 this 指针直接调用，绕过了代理对象，导致事务注解失效。
  • 异常类型不对：Spring 默认只对 RuntimeException 回滚。如果你抛出的是 Checked Exception (如 IOException, Exception) 且没配置 rollbackFor，事务会照常提交。
  • 异常被吞了：你在代码里手动 try-catch 捕获了异常并没有再次抛出，Spring 拦截器捕捉不到异常，自然认为是成功的。

5. 报错：org.hibernate.LazyInitializationException: could not initialize proxy - no Session

• 你以为是：数据库连接断了，或者 Hibernate 坏了。
• 实际可能是：
  • 事务边界溢出：你查询了一个 Entity，它是懒加载（Lazy Load）的。当你把这个对象传到 Controller 层或 View 层（此时 Service 层的事务和 Session 已经关闭），再去调用 getOrders() 访问关联属性时，因为 Session 已关，Hibernate 无法再去库里查数据。

6. 报错：NoSuchMethodError / NoSuchFieldError

• 你以为是：代码没编译，或者方法名写错了。
• 实际可能是：
  • Jar 包冲突 (Jar Hell)：你的项目依赖了 Lib-A (v1.0) 和 Lib-B，但 Lib-B 依赖 Lib-A (v2.0)。Maven 可能会根据路径最短原则选择了 v1.0。运行时，Lib-B 尝试调用 v2.0 才有的新方法，结果发现加载进来的 v1.0 里没有，直接报错。这是最经典的依赖灾难。

三、并发与内存层面的'诡异现象'

7. 报错：OutOfMemoryError: Metaspace

• 你以为是：创建的对象太多，堆内存（Heap）爆了。
• 实际可能是：
  • 动态代理泛滥：使用了大量的反射、CGLib、Groovy 脚本或动态生成类的框架。这些框架会不停地生成新的 Class 信息放入 Metaspace（元空间，JDK8+）。如果不卸载这些 ClassLoader，元空间就会爆炸。这通常不是数据量的问题，是类太多的问题。

8. 程序卡死，CPU 0%，无报错

• 你以为是：网络断了，或者程序在空闲。
• 实际可能是：
  • 死锁 (Deadlock)：两个线程互相持有对方需要的锁。
  • 连接池耗尽：数据库连接池（HikariCP/Druid）满了，且所有连接都被借出未还（比如代码里发生了异常但没在 finally 里关闭连接/事务），导致所有新请求无限等待获取连接。

9. 报错：ConcurrentModificationException

• 你以为是：多线程并发修改了集合。
• 实际可能是：
  • 单线程误用：你在使用 foreach (增强 for 循环) 遍历 List 的同时，调用了 list.remove(item)。这破坏了迭代器的内部状态，单线程下照样报错。必须使用 iterator.remove()。

四、字符串与序列化 (类似你的 \x00)

10. 报错：JSON 解析失败 / 乱码

• 你以为是：JSON 格式不对。
• 实际可能是：
  • BOM 头 (Byte Order Mark)：文件保存为 UTF-8 with BOM 格式，文件开头多了看不见的 \uFEFF。Java 的 IO 流读取时默认不去除 BOM，导致 JSON 解析器在第一个字符就报错。
  • 不可见控制字符：类似你的 \x00，或者复制粘贴代码时带入的 \u200b (零宽空格)，导致解析器认为字段名不匹配。

11. 报错：java.io.NotSerializableException

• 你以为是：某个对象没实现 Serializable 接口。
• 实际可能是：
  • 内部类持有引用：你序列化了一个看似普通的对象，但它是一个非静态内部类。非静态内部类默认持有一个外部类的引用（this$0）。如果外部类不可序列化，整个序列化就会失败。

总结

在 Java 排查问题时，永远记住：'堆栈的最顶层往往只是受害者，凶手在底层或上游。'

1. NPE 不一定是对象没初始化，可能是拆箱。
2. 找不到类 不一定是没包，可能是初始化失败。
3. 事务失效 不一定是配置错，可能是你绕过了代理。
4. OOM 不一定是数据多，可能是动态类生成太多。