解决ImageTranscoder(PNGTranscoder/JPEGTranscoder/TIFFTranscoder)转图片时的中文乱码问题

时间:2025-03-25 08:48:30

问题详情:

代码中使用PNGTranscoderSVG转图片,部署到Linux服务器后,图片中的中文出现乱码(呈方格状)

背景情况:

  • PNGTranscoderJPEGTranscoderTIFFTranscoder均为ImageTranscoder的子类,类中没有相应的编码格式及字体的配置;
  • Windows 中文版的环境下不会出现该异常;
  • 针对此问题,网上很多文章写了很多步骤,但不能解决问题。

问题原因&解决办法(以CentOS 7 为例):

其实就是Linux缺了中文字体,三个步骤解决:一是确保SVG正常,二是增加中文字体,三是重启Java服务。

步骤一:确保SVG正常(一般都是正常的)
打开SVG文件瞅瞅,里面的中文是否正常,如果有问题,先行处理。

步骤二:增加中文字体

# 安装 fontconfig
yum install -y fontconfig
# 查看中文字体列表 如果没有记录 则表示没有中文字体
fc-list :lang=zh 
# 进入字体目录
cd /usr/share/fonts 
# 创建存放中文字体的目录
mkdir chinese
# 进入该目录
cd chinese

将字体拷贝到/usr/share/fonts/chinese(可直接从Windows的C:\Windows\Fonts中取字体)

# 安装 mkfontscale  
yum install -y mkfontscale  
# 执行以下的字体配置命令
sudo mkfontscale  
sudo mkfontdir
sudo fc-cache -fv

步骤三:重新运行Java服务
重新启动Java服务(不用重启机器)!

完成了此三个步骤,再转图片,乱码消失。

. 网上很多文章说,得把系统的语言切换到zh_CN.UTF-8,其实不需要