Activiti Modeler整合之后，部署之后流程图片显示乱码问题分析与解决

比眉伴天荒 2022-06-06 10:21 299阅读 0赞

# Activiti 流程图片显示乱码问题分析与解决 #

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

## 表现 ##

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

1.  所有中文字符变成方块  
    
    
    ![1240][]  
    
2.  所有中文字符变成无意义汉字  
    
    
    ![1240 1][]

造成这两种情况的错误原因以及解决方法并不相同，但都与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流程引擎定义的地方

<bean id="processEngineConfiguration" class="org.activiti.spring.SpringProcessEngineConfiguration">
        <property name="dataSource" ref="dataSource"/>
        <property name="transactionManager" ref="transactionManager"/>
        <property name="databaseSchemaUpdate" value="true"/>
        ...

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

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

正如上所说，这只是window下的解决办法，在linux系统上仍然会出现乱码，这是因为

本人系统activiti配置文件设置的“宋体”，因此需在window系统中找到宋体字体复制到linux系统中进行安装。

1，进入C:\\Windows\\Fonts，找到“宋体 常规”文件simsun.ttc

![Image 1][]

2，进入cd /usr/java/jdk1.7.0\_79/jre/lib/fonts,新建fallback

3，将此文件复制到此文件夹下，

4，重启服务器，

5，重新部署流程，问题解决

##### 中文字符变成无意义汉字 #####

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

###### 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的代码，可别直接拿来用哦。 ######

##### 显示字符为空白 #####

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

（转载于：http://www.jianshu.com/p/8f8b4de761ab）

[1240]: /images/20220606/1832e3517dbb40f4af8b8c3b50865a35.png
[1240 1]: /images/20220606/bf047a824a7b4c41b43061506edf33f9.png
[Image 1]: