<think>好的，用户遇到了一个错误：“
Font '/
font/
simsun.ttc' with 'Identity-H' is
not recognized
.”。首先，我需要分析可能的原因。根据经验，这类错误通常与字体路径、字体文件格式或编码方式有关。
首先，用户使用的字体路径是否正确？路径中的“/
font/
simsun.ttc”可能没有正确指向实际文件。尤其是在项目中，资源文件的路径处理可能会出问题，比如是否放在了正确的资源目录下，是否使用了相对路径或绝对路径。用户可能需要检查文件是否存在，并确认路径是否正确。另外，使用Cl
assLoader
.get
Resource()来获取绝对路径可能更可靠，避免相对路径的问题。
其次，
simsun.ttc是一个TrueType Collection文件，即
TTC格式。iText是否支持直接加载
TTC文件？记得iText在处理
TTC时可能需要特殊处理，比如提取其中的特定字体子集。用户可能需要使用
FontProgramFact
ory来加载
TTC，并指定索引来选择具体的字体，比如0或1，因为
TTC可能包含多个字体样式。
另外，编码问题也是一个可能因素。用户使用了Identity-H编码，这通常用于Unicode编码，特别是中文。但需要确认字体本身是否支持所需的字形。如果字体文件损坏或者不支持中文，即使编码正确，也会出现识别问题。此外，检查是否正确地设置了EmbeddingStrategy，确保字体被正确嵌入
PDF中。
还有可能用户没有正确注册字体。iText需要明确创建字体对象，如果只是指定路径而没有正确调用
PdfFontFact
ory
.create
Font，可能会导致字体未被识别。代码示例是否正确？用户是否遗漏了某些参数，比如编码或嵌入策略？
另外，版本兼容性也是一个考虑因素。用户使用的iText版本是否支持
TTC文件？早期的版本可能不支持，或者需要额外的处理。查看iText的文档，确认当前版本对
TTC的支持情况。
最后，权限问题也可能导致字体加载失败，比如字体文件没有读取权限，或者被其他进程占用。用户需要检查文件权限是否允许应用程序读取该字体文件。
总结下来，可能的解决步骤包括：检查字体路径是否正确，确认
TTC文件处理方式，提取特定字体子集，确保编码设置正确，检查iText版本是否支持，以及验证文件权限。需要逐步排除这些可能性，帮助用户解决问题。</think>在 iText
PDF 中使用
TTC 字体文件时出现 `
Font '/
font/
simsun.ttc' with 'Identity-H' is
not recognized` 错误，通常由以下原因导致。以下是分步排查和解决方案：
---
### 1
. **
TTC 字体文件的特殊性**
**问题定位**
`
.ttc`（TrueType Collection）文件包含多个字体子集（如常规体、粗体等），而 iText 默认无法直接加载整个
TTC 文件，需**明确指定子集索引**。
**解决方案**
```java
// 使用
FontProgramFact
ory 加载
TTC 并指定子集索引（例如 0 表示第一个字体）
FontProgram
fontProgram =
FontProgramFact
ory
.create
Font("
fonts/
simsun.ttc", 0); // 索引可能为 0 或 1
PdfFont font =
PdfFontFact
ory
.create
Font(
fontProgram,
PdfEncodings
.IDENTITY_H, true);
```
---
### 2
. **字体路径验证**
**问题定位**
路径 `/
font/
simsun.ttc` 可能未正确指向实际文件（尤其从 JAR 包运行时需用 `Cl
assLoader` 加载资源）。
**解决方案**
```java
// 使用类加载器获取绝对路径
String
fontPath = getCl
ass()
.getCl
assLoader()
.get
Resource("
fonts/
simsun.ttc")
.get
File();
FontProgram
fontProgram =
FontProgramFact
ory
.create
Font(
fontPath, 0);
```
---
### 3
. **编码强制匹配**
**问题定位**
若字体文件未包含完整的 Unicode 字符集（如仅支持 GB2312），使用 `Identity-H` 编码可能导致兼容性问题。
**验证方法**
```java
// 检查字体是否支持中文
System
.out
.println(
fontProgram
.get
FontNames()
.get
FontName()); // 输出字体名称
System
.out
.println(
fontProgram
.getNumberOfGlyphs()); // 检查包含的字形数量（中文需 > 20000）
```
---
### 4
. **依赖版本兼容性**
**问题定位**
iText 7
.1
.x 以下版本对
TTC 文件支持不完善。
**Maven 依赖更新**
```xml
<dependency>
<groupId>com
.itext
pdf</groupId>
<artifactId>itext7-c
ore</artifactId>
<version>7
.2
.5</version> <!-- 使用最新稳定版 -->
</dependency>
```
---
### 5
. **字体文件完整性检查**
**操作步骤**
1
. 用字体工具（如
FontF
orge）打开 `
simsun.ttc`，确认是否包含有效字体
2
. 尝试提取 `
.ttc` 中的单个 `
.ttf` 文件使用（推荐工具：[
ttc2ttf](https://github
.com/HOST-Oman/
ttc2ttf)）
---
### 完整代码示例
```java
imp
ort com
.itext
pdf.io
.font.FontProgram;
imp
ort com
.itext
pdf.io
.font.FontProgramFact
ory;
imp
ort com
.itext
pdf.kernel
.font.PdfFont;
imp
ort com
.itext
pdf.kernel
.font.PdfFontFact
ory;
imp
ort com
.itext
pdf.kernel
.pdf.PdfDocument;
imp
ort com
.itext
pdf.kernel
.pdf.PdfWriter;
imp
ort com
.itext
pdf.layout
.Document;
public cl
ass Fix
TtcFontErr
or {
public static void main(String[] args) {
try {
// 加载
TTC 文件并指定子集索引
FontProgram
fontProgram =
FontProgramFact
ory
.create
Font("
fonts/
simsun.ttc", 0);
// 创建支持中文的字体对象
PdfFont font =
PdfFontFact
ory
.create
Font(
fontProgram,
PdfEncodings
.IDENTITY_H,
true // 强制嵌入字体
);
// 生成
PDF
PdfDocument
pdf = new
PdfDocument(new
PdfWriter("output
.pdf"));
Document doc = new Document(
pdf);
doc
.add(new Paragraph("测试宋体字体显示")
.set
Font(
font));
doc
.close();
} catch (Exception e) {
e
.printStackTrace();
}
}
}
```
---
### 错误排查流程图
```mermaid
graph TD
A[报错:
Font not recognized] --> B{是否使用
TTC文件?}
B -->|是| C[指定子集索引加载]
B -->|否| D[检查普通TTF路径]
C --> E[验证字体编码为Identity-H]
E --> F[更新iText到7
.2
.5+]
F --> G[检查字体文件完整性]
G --> H[成功显示]
```
通过以上步骤可系统性解决
TTC 字体加载问题。
本文详细解析了在导出PDF时遇到的simsun.ttc字体缺失问题,包括检查字体路径、确认字体文件存在及文件正确性,并分享了解决方案——创建正确路径并上传字体文件。
扫一扫
5430
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
