Tess4J 运行报 UnsatisfiedLinkError 是因依赖本地 libtesseract 和 liblept 动态库，Maven 不自动部署；需按平台配置 native 库路径及 tess4j-platform classifier，并正确设置中文字库路径、语言码与权限。
为什么 Tess4J 引入后一运行就报 UnsatisfiedLinkError
根本原因是 Tess4J 是 JNI 包装器，必须依赖本地 libtesseract 和 liblept 动态库。Maven 只拉 Java 层 jar，不自动部署 native 库。
常见错误现象：java.lang.UnsatisfiedLinkError: The specified module could not be found（Windows）或 libtesseract.so: cannot open shared object file（Linux）。
- Windows 下需手动把
tess4j.dll、liblept.dll放到java.library.path指向的目录（如jre/bin或自定义路径），再用System.setProperty("jna.library.path", "your/path")提前设置 - macOS 需确保
libtesseract.dylib和liblept.dylib在/usr/local/lib或通过-Djna.library.path=...指定 - Maven 里别只加
tess4j，还得显式引入对应平台的tess4j-platformclassifier（如win-x86-64），否则 runtime 找不到适配的 native 包
如何让 Tess4J 正确加载中文字库（chi_sim.traineddata）
Tess4J 默认只认 tessdata 目录下的英文库，中文识别必须手动指定路径和语言码，且字库文件名、编码、版本必须严格匹配。
使用场景：识别简体中文截图、PDF 图片页、扫描件等含汉字内容。
立即学习“Java免费学习笔记（深入）”；
在调试 Java 后端 API 故障时使用此技能，尤其适用于以下任务：分析日志、跨 Controller、Service 和 Mapper 层追踪请求、定位异常根因、检查 SQL 执行或参数流转，以及生成简洁的诊断结论与修复方案。
- 下载对应 Tesseract 版本的
chi_sim.traineddata（例如 Tesseract 5.x 用 tessdata_fast 里的，别用旧版tessdata主干） - 把字库文件放在任意路径（如
src/main/resources/tessdata/chi_sim.traineddata），初始化时用绝对路径传给setDatapath()，不是只设目录名 - 创建
Tesseract实例后必须调用instance.setLanguage("chi_sim")，写成"chi_simulated"或漏掉这步都会静默回退到eng - 注意编码：Tesseract 4+ 的
chi_sim是 UTF-8 编码训练的，若图片有乱码或漏字，优先检查图片预处理（二值化强度、DPI 是否 ≥300）而非换字库
Tess4J 初始化卡住或识别慢的三个硬性条件
不是代码写得有问题，而是 Tesseract 引擎启动本身对资源敏感，尤其在容器、低内存或首次调用时表现明显。
性能影响点集中在初始化阶段：OCR 引擎加载、字库解析、LSTM 模型映射。
- 避免每次识别都 new
Tesseract实例——它不是线程安全但可复用，建议单例 +setPageSegMode()按需重置 - 首次调用
doOCR()前会解压并 mmap 字库，若chi_sim.traineddata放在 jar 包内（如classpath:/tessdata/），必须先用IOUtils.toByteArray(getClass().getResourceAsStream(...))提取到临时文件，Tess4J不支持直接读 jar 内字库 - Linux 容器里若报
libgomp.so.1: cannot open shared object file，说明缺 OpenMP 运行时，要apt-get install libgomp1，否则进程卡死无日志
Java 项目里 Tess4J 和系统已装 Tesseract 的关系
完全无关。Tess4J 自带精简版 native 库，不读系统 PATH 下的 tesseract 命令，也不共用其 tessdata 目录。
容易踩的坑是以为“我服务器上 tesseract -v 能跑，Java 就能用”，结果还是报 native 加载失败。
- 删掉系统 Tesseract 对 Tess4J 运行没影响，反之亦然
- 想调试字库路径是否正确？在
Tesseract实例上调用getDatapath()和getLanguage()，打印出来看是不是你设的绝对路径和"chi_sim" - 如果要用 Tesseract 5.3+ 的新模型（如
osd.traineddata检测方向），得确认你引的tess4j版本 ≥ 5.2.0，老版本（如 4.5.4）只兼容 Tesseract 4.x 的 API
最常被忽略的是字库文件权限和路径拼写——Windows 下反斜杠没转义、Linux 下大小写写成 Chi_Sim、macOS 上从浏览器下载的 .traineddata 文件带隐藏的 ._ 元数据，都会导致加载静默失败。
