JFreeChart SpiderWebPlot生成PDF时日文字符不显示问题求助

核心问题排查与解决步骤 #

1. 先把字体注册到Java环境 #

你加载了字体但未注册到系统环境，JVM可能无法在PDF渲染阶段调用该字体，补充注册代码：

ClassLoader classLoader = ReportVariables.class.getClassLoader();
URL resource = classLoader.getResource("notoSansRegular.ttf");
assert resource != null;
// 加载基础字体文件
Font baseFont = Font.createFont(Font.TRUETYPE_FONT, resource.openStream());
// 注册到本地图形环境
GraphicsEnvironment ge = GraphicsEnvironment.getLocalGraphicsEnvironment();
ge.registerFont(baseFont);
// 生成带字号的可用字体对象
Font notoFont = baseFont.deriveFont(Font.PLAIN, 12f);

2. 给所有相关组件设置字体 #

仅设置setLabelFont不够，蜘蛛图的分类标签、图例等元素都需要指定字体：

SpiderWebPlot spiderWebPlot = new SpiderWebPlot(dataset);
// 设置蜘蛛图的径向标签字体
spiderWebPlot.setLabelFont(notoFont);

// 给整个图表的其他元素配置字体
JFreeChart chart = new JFreeChart("蜘蛛分析图", notoFont.deriveFont(Font.BOLD, 14f), spiderWebPlot, true);
// 设置图例字体
chart.getLegend().setItemFont(notoFont);

3. 验证字体文件的正确性 #

确保你使用的是支持日文的Noto Sans CJK JP版本，普通Noto Sans不包含日文字形，无论怎么设置都无法显示日文。

4. PDF导出时强制嵌入字体 #

如果使用iText导出PDF，必须将字体嵌入到PDF文件中，否则打开PDF的设备若无对应字体仍会显示异常：

// iText导出PDF示例（适配JFreeChart）
Document document = new Document();
PdfWriter writer = PdfWriter.getInstance(document, new FileOutputStream("spider_chart.pdf"));
document.open();

// 加载并嵌入中日韩字体
BaseFont embeddedFont = BaseFont.createFont("NotoSansCJKjp-Regular.ttf", BaseFont.IDENTITY_H, BaseFont.EMBEDDED);
Font pdfFont = new Font(embeddedFont, 12);

// 将绘制好的图表转换为PDF模板
PdfContentByte cb = writer.getDirectContent();
PdfTemplate template = cb.createTemplate(600, 400);
Graphics2D g2 = template.createGraphics(600, 400, new DefaultFontMapper());
chart.draw(g2, new Rectangle2D.Double(0, 0, 600, 400));
g2.dispose();

cb.addTemplate(template, 50, 50);
document.close();

5. 快速测试字体有效性 #

写个简单的饼图测试代码，排除蜘蛛图组件的特殊问题，验证字体是否能正常渲染日文：

DefaultPieDataset testDataset = new DefaultPieDataset();
testDataset.setValue("日本語テスト", 60);
testDataset.setValue("項目B", 40);
JFreeChart testChart = ChartFactory.createPieChart("テストタイトル", testDataset, true, true, false);
testChart.getTitle().setFont(notoFont);
testChart.getLegend().setItemFont(notoFont);
// 导出为图片或PDF，验证日文显示情况

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