解决iText 5.0.1生成pdf，加入iTextAsian.jar 出现异常 Font 'STSong-Light' with 'UniGB-UCS2-H' is not recognized.的

最新推荐文章于 2026-07-23 11:14:23 发布

转载最新推荐文章于 2026-07-23 11:14:23 发布 · 3w 阅读

本文解决iText 5.0.1版本中亚洲字体显示问题，通过修改itextasian.jar包名使其兼容新版iText。具体步骤包括解压、修改包名及重新打包。

iText的最新版本5.0.1,官方的binary版本还是没直接集成对asian font的解决方案，加载itextasian.jar到classpath下一直不工作，提示如下错误：
    Font 'STSong-Light' with 'UniGB-UCS2-H' is not recognized
    整了半天也没弄对路径，只好去查看源代码，找到CJKFont类, 从中看到
                InputStream is = getResourceStream(RESOURCE_PATH + "cjkfonts.properties");
                cjkFonts.load(is);
                is.close();
                is = getResourceStream(RESOURCE_PATH + "cjkencodings.properties");
                cjkEncodings.load(is);
                is.close();
    他的font和encoding文件都是从String RESOURCE_PATH = "com/itextpdf/text/pdf/fonts/"; 这里加载的,而老itextasian.jar的包名是com.lowagie.text.pdf.fonts, 应该是包名重新命名了, 而没有及时更新itextasian.jar, 改了一下itextasian.jar包路径, 重新运行程序, OK, 搞定.

×××××××××××××××××××××××××××××××××××××××××××

更改iTextAsian.jar包名的方法如下
1)使用winrar解压缩程序将原来的iTextAsian.jar解压，目录结构如下
iTextAsian
     --com
        --lowagie
          --text
            --pdf
              --fonts
                --...(字体属性文件)
2)将加压后com目录下的包名lowagie更改为itextpdf
3)在命令行转至iTextAsian目录，重新打包为iTextAsian.jar文件
命令如下：
     jar cvf iTextAsian.jar com/itextpdf/text/pdf/fonts/*
执行后，将新的iTextAsian.jar加入到classpath路径
    注：谷歌了一下，iText从5.0.0版本起就重新命名了，但itextasian.jar的包命名一直没有改动。