使用Graphics2D在BufferedImage绘图时抛出sg2d.loops空指针异常

异常核心问题 #

说白了就是你用的SunGraphics2D实例里的loops字段没初始化，底层渲染管道没法正常干活，才抛出这个NPE。一般都是这些场景导致的：

常见坑点和修复办法 #

1. 手动创建了SunGraphics2D对象 #

SunGraphics2D是Java内部的私有实现类，绝对不能自己new出来用！必须通过BufferedImage的createGraphics()方法获取合法的Graphics2D实例：

// 正确姿势
BufferedImage image = new BufferedImage(200, 200, BufferedImage.TYPE_INT_ARGB);
Graphics2D g2d = image.createGraphics();
// 执行绘制操作
g2d.drawRect(10, 10, 50, 50);
// 用完记得释放资源
g2d.dispose();

要是直接new SunGraphics2D()，必然会因为没初始化loops字段炸锅。

2. 复用了已经dispose的Graphics2D对象 #

调用g2d.dispose()之后，这个对象的底层资源已经被回收，再拿来用肯定出问题。记住：

• 别用已经dispose过的Graphics2D实例
• 要么一次性完成所有绘制再dispose，要么每次绘制前重新获取新的实例

3. 多线程里乱共享Graphics2D #

如果多个线程共用同一个Graphics2D对象，很可能出现一个线程刚dispose，另一个线程还在绘制的情况，直接搞崩对象状态。解决办法：

• 每个线程自己创建专属的Graphics2D实例
• 对共享的BufferedImage和Graphics2D加锁，避免并发操作

4. 用了奇怪的BufferedImage类型 #

有些自定义的ColorModel或者特殊图像类型，可能没法正确初始化Graphics2D的渲染管道。试试换成标准的图像类型：

// 优先用这些标准类型：
BufferedImage.TYPE_INT_RGB
BufferedImage.TYPE_INT_ARGB
BufferedImage.TYPE_4BYTE_ABGR

验证步骤 #

1. 查遍代码里所有获取Graphics2D的地方，确保全是用BufferedImage.createGraphics()拿的
2. 确认没有在dispose之后还继续用同一个对象
3. 要是有多线程操作，检查有没有共享Graphics2D的情况
4. 临时换成标准图像类型，看看是不是类型的锅

内容的提问来源于stack exchange，提问作者GZY_mingbai