PdfBox 3.0.0-alpha3版本PDType1Font构造函数调用无限挂起问题

问题复现 #

升级PdfBox至3.0.0-alpha3版本后，按新接口调整PDType1Font调用逻辑，使用的构造函数签名如下：

PDType1Font(Standard14Fonts.FontName baseFont)

对应实现代码：

FontName font_name_3v= Standard14Fonts.getMappedFontName("HELVETICA_BOLD");
PDFont pdfFont=  new PDType1Font(font_name_3v);

代码执行到PDType1Font实例化行时，程序无限挂起无响应。

问题根因 #

• 方法误用：Standard14Fonts.getMappedFontName()的作用是兼容旧版本PdfBox的字体名称字符串（比如横杠分隔的Helvetica-Bold），映射返回对应枚举值。传入的"HELVETICA_BOLD"是枚举常量的字段名，不是旧版兼容字体名，该方法无法正确识别，会返回非预期值，触发后续初始化异常。
• 版本缺陷：3.0.0-alpha3是预览测试版本，本身存在标准字体初始化的类加载死锁bug：内部加载AFM字体资源时静态代码块存在锁竞争，多线程并发初始化字体时大概率触发无限阻塞，传入非法字体值时单线程也可能触发资源加载死循环。

修复方案 #

• 修正字体获取逻辑：不需要调用getMappedFontName，直接引用枚举值即可：

  Standard14Fonts.FontName fontName = Standard14Fonts.FontName.HELVETICA_BOLD;
  PDFont pdfFont = new PDType1Font(fontName);
  

• 替换版本：alpha3属于早期预览版，稳定性差，直接升级到3.0.x正式稳定版即可，该初始化死锁问题在正式版中已完全修复。
• 若必须使用alpha3版本，在程序启动阶段单线程预先加载所有用到的标准字体，避免多线程并发初始化触发锁竞争。

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