activiti 启动tomcat乱码_Activiti 流程图片显示乱码问题分析与解决

Activiti新手常见的问题是，部署成功流程后，获取显示的流程图片(PNG)为乱码，主要体现为中文无法正确显示。在这里分析一下乱码出现的原因，以及解决方案。不喜欢问为什么的同学可以直接跳到解决方法段落。

表现

Activiti流程图乱码常见有两种情况：

所有中文字符变成方块

所有中文字符变成无意义汉字

造成这两种情况的错误原因以及解决方法并不相同，但都与Activiti部署、生成流程图的方法有关。下面先介绍Activiti的流程图生成方式。

背景介绍

Activiti中，使用的流程定义一般都是符合BPMN2.0标准的xml文本文件，后缀可以是.bpmn20.xml，.xml。其中包含了流程的全部定义内容，包括各节点、节点关联关系，以及用于定义显示的DI元素。

在部署流程定义时，Activiti引擎会判断，是否同时提供了流程图文件？如果一起提供了流程图文件，Activiti就省事了，直接使用这个文件作为流程图。

一般来说我们都不会先制作好流程图文件再部署，也就是说，部署时只有一个xml文件。这时候Activiti就需要自己生成对应的流程图文件了。

流程图文件会保存在Activiti的数据库ACT_GE_BYTEARRAY表中，作为BLOB保存。每个流程对应一个流程图文件。所以流程图在部署时就已经确定，除非重新部署或手动处理，否则不管配置怎么修改，显示的都是最初的流程图。

Activiti用于生成流程图的工具类是

org.activiti.image.impl.DefaultProcessDiagramGenerator

这个类不止可以生成流程图，还可以生成流程运行状态图。具体可以参阅其中各方法的注释。

出错原因分析

中文字符变成方块

在部署流程时，生成流程图的代码位于

org.activiti.engine.impl.bpmn.deployer.BpmnDeployer.deploy():154 (Activiti 5.22中)

byte[] diagramBytes = IoUtil.readInputStream(processEngineConfiguration.

getProcessDiagramGenerator().generateDiagram(bpmnParse.getBpmnModel(), "png", processEngineConfiguration.getActivityFontName(),

processEngineConfiguration.getLabelFontName(),processEngineConfiguration.getAnnotationFontName(), processEngineConfiguration.getClassLoader()), null);

可见在这里，需要在processEngineConfiguration里，保存有正确的LabelFontName，以及AnnotationFontName作为参数，Generator才能正确生成(非英文)的流程图片。

中文字符变成无意义汉字

出现这种问题，基本上都是在Activiti提供的demo程序——Explorer中设计、部署流程的时候出现的。原因是demo程序有bug。

Activiti Explorer中提供的Activiti Modeler，是一个Web流程设计器。用于编辑、保存流程模型。这里请注意，不能用于新建，它生成的也只是流程模型，不是流程定义。生成的流程模型是Json格式的，也保存在ACT_GE_BYTEARRAY表中。

然后在Activiti Explorer中提供了“部署”的操作。对应的代码为(Activiti 5.22中)(实际有两个部署方式，不过画线部署的是这个。另一个是填表单方式部署，问题类似)

org.activiti.editor.ui.EditorProcessDefinitionDetailPanel.deployModelerModel()

protected void deployModelerModel(final ObjectNode modelNode) {

BpmnModel model = new BpmnJsonConverter().convertToBpmnModel(modelNode);

byte[] bpmnBytes = new BpmnXMLConverter().convertToXML(model);

String processName = modelData.getName() + ".bpmn20.xml";

Deployment deployment = repositoryService.createDeployment()

.name(modelData.getName())

.addString(processName, new String(bpmnBytes))

.deploy();

ExplorerApp.get().getViewManager().showDeploymentPage(deployment.getId());

}

大意是，将Modeler的数据格式(Json modelNode),转换为Activiti内部交换格式(BpmnModel model)，再转成xmlbyte(byte[] bpmnBytes)，然后在部署的时候再作为String加入部署

.addString(processName, new String(bpmnBytes))

很绕是不是？Activiti的开发者也把自己绕晕了，导致这里出现了bug。

public byte[] convertToXML(BpmnModel model) {

return convertToXML(model, DEFAULT_ENCODING);

}

转换为xmlbyte的方法里，指定了编码方式(为UTF-8)。但是再转回字符串的时候，却没有指定编码方式！

new String(bpmnBytes)

在未指定编码方式的时候，new String使用jvm定义的默认编码方式解析，而我们一般使用的都是gb2312，因此导致问题。

解决方法

再次强调，修改之后，需要重新部署或手动生成流程图片，才能看到效果！

中文字符变成方块

在Activiti的配置中，加上字体配置即可。

对于Spring用户，在Spring配置文件中找到Activiti流程引擎定义的地方

...

在其中加上几个参数(按照Activiti的版本不同，参数数量不一定。用IDE提示，把所有带有font的都设置上就好了)。字体可以按照喜好设置，但需要保证tomcat运行时可以找到(例如默认安装的linux服务器很可能就没有)。

重启tomcat使配置生效，重新部署流程以重新生成流程图。方块字就ok啦。

中文字符变成无意义汉字

由于问题出在编码方式上，因此有几种修改方式

1. 修改jvm默认参数。

在tomcat的vm运行参数上，加上-Dfile.encoding=UTF-8。不过副作用是导致整个项目都运行在utf-8下，对于写的不严谨的项目，可能导致其它地方默认使用gb2312编码的代码出错。

2. 修改Explorer部署部分的代码

将org.activiti.editor.ui.EditorProcessDefinitionDetailPanel.deployModelerModel():348

修改为.addString(processName, new String(bpmnBytes, "UTF-8"))即可。

可以直接修改activiti的源码，编译后使用。

也可以在自己的项目下，手动创建org.activiti.editor.ui.EditorProcessDefinitionDetailPanel类，把Activiti的源码贴进去，再修改正确。这样我们重写的类就会由classloader优先加载，覆盖Activiti自己的实现，达到修改的目的。

3. 说到底Explorer只是Activiti提供的demo样例。自己写的时候，可以参考Explorer的代码，可别直接拿来用哦。

显示字符为空白

这个严格来说并不是“乱码”，解决方法也很简单：画流程图的时候，少写几个字，或者把框框拖动搞大一点就可以了~