<think>我们面对的核心问题是：Jasper Report在输出PDF时需要用到MS明朝字体，但我们只有ttc格式的字体文件（msmincho.ttc），而Jasper Report默认
不支持直接使用ttc文件。
解决方案的核心思路是将ttc文件拆分为多个ttf文件，然后在Jasper Report中使用这些ttf文件。具体步骤如下：
### 1. 从ttc文件中提取ttf字体
MS明朝的ttc文件包含多个字体样式（如常规体、粗体等）。我们需要使用工具将ttc拆分成单独的ttf文件。推荐使用`fonttools`（Python库）或FontForge（图形界面或命令行）进行拆分。
#### 使用fonttools（命令行）：
1. 安装fonttools：
```bash
pip install fonttools
```
2. 拆分ttc文件：
```bash
pyftools extract msmincho.ttc
```
此命令会生成多个ttf文件（如：msmincho-0.ttf, msmincho-1.ttf等）。通常，0对应常规体，1对应粗体。
#### 使用FontForge（命令行）：
1. 安装FontForge（具体安装方法取决于操作系统）。
2. 执行以下命令提取常规体（索引0）和粗体（索引1）：
```bash
fontforge -lang=ff -c "Open('msmincho.ttc'); Generate('msmincho_regular.ttf', 0); Generate('msmincho_bold.ttf', 1);"
```
### 2. 将提取的ttf文件添加到Jasper Report
将生成的ttf文件（如`msmincho_regular.ttf`和`msmincho_bold.ttf`）放入项目的资源目录（例如：`src/main/resources/fonts/`）。
### 3. 在Jasper Report中注册字体
有两种方式注册字体：
#### 方式一：通过`fonts.xml`配置文件（推荐）
1. 创建`fonts.xml`文件（位置：`src/main/resources/fonts/fonts.xml`）：
```xml
<fontFamilies>
<fontFamily name="MSMincho">
<normal>fonts/msmincho_regular.ttf</normal>
<bold>fonts/msmincho_bold.ttf</bold>
<pdfEncoding>Identity-H</pdfEncoding>
<pdfEmbedded>true</pdfEmbedded>
</fontFamily>
</fontFamilies>
```
2. 确保在编译时该文件被打包到类路径中（Maven项目会自动处理）。
#### 方式二：在代码中动态注册（
不推荐，但有时必须）
在生成报表之前，通过Java代码注册字体：
```java
try {
// 注册常规体
InputStream regularFontStream = YourClass.class.getResourceAsStream("/fonts/msmincho_regular.ttf");
FontUtil.registerFont("MSMincho", regularFontStream, "Identity-H", true);
// 注册粗体
InputStream boldFontStream = YourClass.class.getResourceAsStream("/fonts/msmincho_bold.ttf");
FontUtil.registerFont("MSMincho-Bold", boldFontStream, "Identity-H", true);
} catch (JRException e) {
e.printStackTrace();
}
```
注意：在Jasper Reports中，字体是按字体系列（family）注册的，但上述代码分别注册了两个独立的字体（MSMincho和MSMincho-Bold）。为了与报表设计中的样式匹配，通常需要在报表设计中将常规文本的字体设置为“MSMincho”，粗体文本的字体设置为“MSMincho-Bold”。或者，我们可以通过扩展字体系列的方式，将常规体和粗体都绑定到同一个字体系列名（如上述`fonts.xml`配置）。代码动态注册字体系列较为复杂，建议使用`fonts.xml`方式。
### 4. 在报表设计中使用字体
在JasperSoft Studio中设计报表时：
1. 打开报表文件（.jrxml）。
2. 选择需要设置字体的文本元素（如staticText、textField）。
3. 在属性面板的“Font”选项卡中：
- Font Name: 选择“MSMincho”（即我们在`fonts.xml`中定义的family name）。
- PDF Font Name: 也设置为“MSMincho”。
- PDF Encoding: 选择“Identity-H”（支持Unicode）。
- 勾选“Embed this font”。
### 5. 导出PDF时确保嵌入字体
在导出PDF的代码中，确保设置了嵌入字体：
```java
JRPdfExporter exporter = new JRPdfExporter();
exporter.setExporterInput(new SimpleExporterInput(jasperPrint));
exporter.setExporterOutput(new SimpleOutputStreamExporterOutput(outputStream));
SimplePdfExporterConfiguration configuration = new SimplePdfExporterConfiguration();
configuration.setEmbedded(true); // 关键：嵌入字体
exporter.setConfiguration(configuration);
exporter.exportReport();
```
### 注意事项
1. **字体嵌入**：务必在报表设计（jrxml）和导出配置中都设置嵌入字体，以确保客户端正确显示。
2. **字符编码**：使用`Identity-H`编码支持日文字符。
3. **字体文件路径**：确保ttf文件在运行时位于类路径中（如JAR文件内）。
### 验证
导出PDF后，使用PDF阅读器（如Adobe Acrobat）检查文档属性中的字体，确认MSMincho字体已嵌入。
### 替代方案：使用iText
如果上述方法仍无法解决，可以考虑直接使用iText（Jasper Reports底层使用iText生成PDF）来注册字体。但这种方法需要修改Jasper Reports的PDF生成过程，较为复杂。基本思路是：
1. 创建一个自定义的`PdfFont`对象（使用iText）。
2. 在`JRPdfExporter`的`exportReport`方法中，使用自定义的字体替换逻辑。
由于此方法需要深入定制，且破坏了Jasper Reports的封装，因此
不推荐优先使用。
### 总结
通过将ttc拆分为ttf并在Jasper Report中注册，我们可以解决MS明朝字体在PDF输出中的使用问题。主要步骤包括：
1. 使用工具（如fonttools或FontForge）拆分ttc文件。
2. 将生成的ttf文件放入资源目录。
3. 通过`fonts.xml`或代码注册字体。
4. 在报表设计中使用注册的字体，并设置嵌入和编码。
5. 在导出PDF时配置嵌入字体。
§§相关问题§§
1. 如何为Jasper Report添加其他日文字体（如MS Gothic）？
2. 在Linux服务器上部署时，如何处理字体问题？
3. 如何解决Jasper Report导出PDF时中文显示为方框的问题？
4. 如何在
不使用工具的情况下将ttc文件转换为ttf？
</think>
### Jasper Report 输出 PDF 使用 MS明朝 (msmincho.ttc) 的解决方案
#### 核心问题分析
MS明朝字体以 **TrueType集合(.ttc)** 格式分发，而 Jasper Reports 原生仅支持 **TrueType(.ttf)** 字体格式。需通过以下步骤解决兼容性问题[^1]：
---
### 详细解决步骤
#### 1. **提取 TTC 中的 TTF 字体**
```bash
# 使用 fonttools 提取 TTC 中的 TTF
pip install fonttools
pyftsubset msmincho.ttc --text="*" --output-file=msmincho_regular.ttf --flavor="ttf" --font-number=0
```
- 参数说明：
- `--font-number=0`：提取常规体（索引0）
- `--font-number=1`：提取粗体（索引1）
- **验证提取结果**：
```bash
file msmincho_regular.ttf # 应显示 "TrueType font data"
```
#### 2. **Jasper Reports 字体注册**
**方法一：XML 配置文件（推荐）**
创建 `fonts.xml`：
```xml
<fontFamilies>
<fontFamily name="MSMincho">
<normal>fonts/msmincho_regular.ttf</normal>
<bold>fonts/msmincho_bold.ttf</bold>
<pdfEncoding>Identity-H</pdfEncoding> <!-- Unicode编码 -->
<pdfEmbedded>true</pdfEmbedded> <!-- 强制嵌入 -->
</fontFamily>
</fontFamilies>
```
- 位置：`src/main/resources/fonts/fonts.xml`
**方法二：Java 代码动态注册**
```java
public void registerMsMincho() throws JRException {
InputStream regular = getClass().getResourceAsStream("/fonts/msmincho_regular.ttf");
InputStream bold = getClass().getResourceAsStream("/fonts/msmincho_bold.ttf");
FontUtil.registerFont("MSMincho", regular, "Identity-H", true);
FontUtil.registerFont("MSMincho-Bold", bold, "Identity-H", true);
}
```
#### 3. **报表设计配置 (JRXML)**
```xml
<textField>
<textElement>
<font
fontName="MSMincho"
pdfFontName="MSMincho"
pdfEncoding="Identity-H"
isPdfEmbedded="true"/>
</textElement>
<textFieldExpression><![CDATA[$F{content}]]></textFieldExpression>
</textField>
```
#### 4. **PDF 导出代码关键配置**
```java
SimplePdfExporterConfiguration config = new SimplePdfExporterConfiguration();
config.setEmbedded(true); // 强制字体嵌入
config.setPdfaConformance(PdfaConformanceEnum.PDFA_1A); // 兼容PDF/A标准
JRPdfExporter exporter = new JRPdfExporter();
exporter.setConfiguration(config);
exporter.exportReport();
```
---
### 常见问题排查
1. **字体未生效**：
- 检查 `fonts.xml` 路径是否正确
- 确认 TTF 文件在最终 JAR/WAR 包中
- 添加日志检查：
```java
FontUtil.getRegisteredFonts().forEach(f -> System.out.println(f.getName()));
```
2. **字符显示为方框**：
- 确保使用 `Identity-H` 编码
- 验证字体是否包含目标字符：
```bash
fc-query msmincho_regular.ttf | grep "charset"
```
3. **Windows 24H2 兼容性**：
- 使用 `pyftsubset` 而非旧工具拆分 TTC
- 添加字体回退机制：
```xml
<exportFonts>
<export key="net.sf.jasperreports.pdf">fonts/msmincho_regular.ttf</export>
</exportFonts>
```
---
### 效果验证
使用 `pdffonts` 检查输出文件：
```bash
pdffonts output.pdf
```
成功输出应包含：
```text
name type emb sub uni
MSMincho CID TrueType yes yes yes
```
---
扫一扫
15万+
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
