<think>好的，我现在需要帮助用户解决他们遇到的异常问题：IOException: The
CMap com/itextpdf/io/font/
cmap/toUnicode/
Adobe-Japan1
-UCS2 was not found.。首先，我需要理解这个错误的原因。
CMap（字符映射表）在PDF处理中用于将字符编码映射到Unicode，尤其是在处理中日韩（CJK）字体时。iText库需要这些
CMap文件来正确解析和生成PDF中的文本，特别是当文档包含非拉丁字符集时。
用户可能在尝试读取或处理一个包含日文字体的PDF文件时遇到了这个问题。错误信息明确指出找不到
Adobe-Japan1
-UCS2的
CMap文件。这可能是因为iText的依赖库不完整，或者构建过程中没有正确包含这些资源。
接下来，我需要回忆iText的相关知识。iText 7及更高版本将
CMap文件作为资源打包在jar中，但有时候如果使用了错误的版本，或者构建工具（如Maven、Gradle）没有正确包含这些资源，就会导致文件缺失。此外，用户可能没有正确配置依赖项，特别是对于CJK字体支持的部分。
然后，我应该考虑用户可能的开发环境。比如，他们是否使用了Maven或Gradle，是否添加了正确的依赖项。例如，除了核心的itext7依赖，还需要添加cjk字体扩展模块，比如io模块中的
CMap资源。用户可能只添加了核心库，而忽略了额外的资源包。
另外，构建过程中是否排除了资源文件？例如，某些构建配置可能会忽略src/main/
resources以外的资源，或者过滤掉某些文件类型，导致
CMap文件没有被正确打包到最终的应用程序中。尤其是在使用阴影Jar（fat jar）时，资源路径可能发生变化，导致iText无法找到这些文件。
接下来，我需要验证
解决方案。首先，确保用户添加了正确的依赖项。例如，对于Maven，需要检查是否包含itext
-io依赖，因为
CMap资源通常位于其中。如果用户使用的是较旧的iText版本，可能需要额外的配置。另外，确认资源文件是否被正确打包到生成的jar中，可以解压jar文件查看是否存在对应的
CMap文件路径。
另一个可能的原因是iText的版本问题。如果用户使用的是社区版（AGPL版本）而不是商业版，某些资源可能不被包含，或者需要手动配置。但通常社区版应该包含基本的
CMap资源。
此外，检查文件路径是否正确。iText在查找
CMap时遵循特定的资源路径结构，如果
项目结构不正确，或者资源文件被错误地放置在错误的目录下，也会导致找不到文件。例如，
CMap文件应该位于类路径下的com/itextpdf/io/font/
cmap/目录中。
最后，可能需要考虑自定义
CMap资源的情况，但这种情况较少见。大多数情况下，问题出在依赖项缺失或构建配置错误。
总结起来，解决这个问题的步骤应该是：检查依赖项是否完整，确认资源文件被打包，验证构建配置，必要时手动添加
CMap资源或调整类路径。同时，提供用户具体的代码示例和配置调整方法，帮助他们一步步解决问题。</think>
---
### 🔍 **问题根源**
您遇到的`IOException`表明iText在类路径中找不到必需的**
CMap资源文件**（`
Adobe-Japan1
-UCS2`）。这类问题通常发生在处理包含**日文字体/CJK字符**的PDF时，根本原因是：
- **
CMap文件缺失**：iText需要特定字符映射表解析非拉丁字符
- **依赖配置不完整**：未包含包含
CMap资源的JAR包
- **构建配置问题**：资源文件未被正确打包到应用程序中
---
### ✅ **
解决方案步骤**
#### 1. 添加完整依赖（关键！）
根据您使用的工具：
**Maven配置**：
```xml
<dependency>
<groupId>com.itextpdf</groupId>
<artifactId>kernel</artifactId>
<version>7.2.5</version>
</dependency>
<dependency>
<groupId>com.itextpdf</groupId>
<artifactId>io</artifactId> <!
-- CMap资源在此模块
-->
<version>7.2.5</version>
</dependency>
```
**Gradle配置**：
```groovy
implementation 'com.itextpdf:kernel:7.2.5'
implementation 'com.itextpdf:io:7.2.5'
```
#### 2. 验证资源打包
检查编译后的JAR/WAR中是否包含：
```
BOOT
-INF/classes/com/itextpdf/io/font/
cmap/toUnicode/
├──
Adobe-Japan1
-UCS2
├──
Adobe-Korea1
-UCS2
└──
Adobe-GB1
-UCS2
```
#### 3. 修复构建配置（示例）
**Maven资源过滤**：
```xml
<build>
<
resources>
<resource>
<directory>src/main/
resources</directory>
<filtering>false</filtering>
<!
-- 禁止过滤二进制文件
-->
<excludes>
<exclude>**/*.
cmap</exclude>
</excludes>
</resource>
</
resources>
</build>
```
---
### ⚠️ **常见错误场景**
#### 案例1：使用`shade`插件未合并资源
```xml
<!
-- maven
-shade
-plugin 配置补丁
-->
<transformers>
<transformer implementation="org.apache.maven.plugins.shade.resource.AppendingTransformer">
<resource>com/itextpdf/io/font/
cmap/toUnicode/
Adobe-Japan1
-UCS2</resource>
</transformer>
</transformers>
```
#### 案例2：自定义字体加载
```java
// 显式注册
CMap路径（备用方案）
PdfDocument pdf = new PdfDocument(new PdfReader("input.pdf"));
pdf.addFont(PdfFontFactory.createRegisteredFont("HeiseiMin
-W3",
PdfEncodings.IDENTITY_H,
PdfFontFactory.EmbeddingStrategy.FORCE_EMBEDDED));
```
---
### 🌐 **
CMap工作原理**
CMap（Character Map）是PDF处理CJK字符的关键组件：
$$ \text{PDF字符编码} \xrightarrow{\text{
CMap}} \text{Unicode码位} $$
- **
Adobe-Japan1**：日文字符集映射
- **
Adobe-GB1**：简体中文映射
- **
Adobe-Korea1**：韩文字符集映射
---
### 🔧 **高级调试技巧**
#### 诊断资源加载：
```java
// 检查类加载器能否找到资源
InputStream
cmapStream = getClass().getResourceAsStream(
"/com/itextpdf/io/font/
cmap/toUnicode/
Adobe-Japan1
-UCS2");
if (
cmapStream == null) {
throw new RuntimeException("
CMap资源未找到！");
}
```
#### 手动添加
CMap：
1. 从[itext源码库](https://github.com/itext/itext7)下载所需
CMap文件
2. 放置到
项目的`src/main/
resources/com/itextpdf/io/font/
cmap/toUnicode/`目录
---
### 📦 **依赖关系拓扑**
```
itext7
-core
├── kernel
└── io // 包含所有
CMap资源
└── src/main/
resources
└── com/itextpdf/io/font/
cmap
```
---
### 🚨 **特别注意**
- 使用**完全相同的版本号**（如kernel 7.2.5必须对应io 7.2.5）
- 避免混用iText 5和iText 7的依赖
- 云原生部署时检查容器内的资源路径
---
通过以上步骤，90%以上的
CMap相关异常可以得到解决。如果问题仍然存在，建议检查依赖冲突（使用`mvn dependency:tree`）或提供完整的堆栈跟踪进一步分析。
项目地址: https://gitcode.com/gh_mirrors/cm/cmap-resources 
扫一扫
733
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
