activiti中文乱码问题如何解决

发布时间：2021-07-22 18:29:05 作者：chen
来源：亿速云阅读：814

# Activiti中文乱码问题如何解决

## 前言

Activiti作为一款流行的开源工作流引擎，在企业级应用中广泛使用。但在实际开发过程中，许多开发者会遇到中文乱码问题，特别是在流程变量、表单数据、任务名称等场景。本文将深入分析Activiti中文乱码问题的根源，并提供多种解决方案。

---

## 一、乱码问题常见场景

1. **流程定义部署时**  
   - BPMN/XML文件中的中文注释或标签显示乱码
   - 流程图节点名称显示异常

2. **运行时数据存储**  
   - 流程变量(Process Variables)中的中文值
   - 用户任务(Task)的名称和描述
   - 历史记录(History)中的中文内容

3. **表单数据交互**  
   - 动态表单中的中文提交内容
   - REST API返回的中文数据

---

## 二、根本原因分析

### 1. 数据库字符集配置不当
Activiti默认使用数据库存储数据，若数据库/表/字段未使用UTF-8编码：
```sql
-- MySQL示例
SHOW VARIABLES LIKE 'character_set%';

2. JDBC连接未指定编码

数据源配置缺少字符集参数：

<!-- 错误示例 -->
<property name="url" value="jdbc:mysql://localhost:3306/activiti"/>

<!-- 正确示例 -->
<property name="url" value="jdbc:mysql://localhost:3306/activiti?useUnicode=true&characterEncoding=UTF-8"/>

3. 服务端响应编码未设置

Web应用未配置统一的字符过滤器：

// Spring Boot示例
@Bean
public FilterRegistrationBean<CharacterEncodingFilter> filterRegistrationBean() {
    FilterRegistrationBean<CharacterEncodingFilter> bean = new FilterRegistrationBean<>();
    bean.setFilter(new CharacterEncodingFilter("UTF-8", true));
    return bean;
}

4. 文件编码不匹配

BPMN设计器与工程文件编码不一致（如Eclipse/IDEA默认编码设置）

三、系统化解决方案

方案1：数据库层修复

MySQL配置示例

修改my.cnf：

[client]
default-character-set=utf8mb4

[mysqld]
character-set-server=utf8mb4
collation-server=utf8mb4_unicode_ci

修改已有表的编码：

ALTER DATABASE activiti CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE ACT_RU_VARIABLE CONVERT TO CHARACTER SET utf8mb4;

建议使用utf8mb4而非utf8以支持完整Unicode字符（如emoji）

方案2：应用层配置

Spring Boot数据源配置

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/activiti?useUnicode=true&characterEncoding=UTF-8&useSSL=false&serverTimezone=UTC
    driver-class-name: com.mysql.cj.jdbc.Driver

添加HTTP编码过滤器

@Configuration
public class WebConfig implements WebMvcConfigurer {
    @Bean
    public CharacterEncodingFilter characterEncodingFilter() {
        CharacterEncodingFilter filter = new CharacterEncodingFilter();
        filter.setEncoding("UTF-8");
        filter.setForceEncoding(true);
        return filter;
    }
}

方案3：Activiti特定配置

流程引擎配置

ProcessEngineConfiguration.createStandaloneProcessEngineConfiguration()
    .setJdbcUrl("jdbc:mysql://...")
    .setDatabaseSchemaUpdate(ProcessEngineConfiguration.DB_SCHEMA_UPDATE_TRUE)
    .setDatabaseType("mysql")
    .setDbIdentityUsed(false)
    .setDbHistoryUsed(true)
    .setXmlEncoding("UTF-8");  // 关键配置

历史记录级别设置

# application.properties
spring.activiti.history-level=full

四、开发环境最佳实践

1. IDE统一编码设置

Eclipse：Window > Preferences > General > Workspace > Text file encoding
IDEA：File > Settings > Editor > File Encodings

2. BPMN设计器配置

使用Activiti Modeler时，确保： 1. 设计器页面添加meta标签：

<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">

导出XML时选择UTF-8编码

3. 流程变量处理建议

// 设置流程变量时明确指定类型
runtimeService.setVariable(
    execution.getId(), 
    "chineseVar", 
    new String("中文内容".getBytes(StandardCharsets.UTF_8), StandardCharsets.UTF_8)
);

五、疑难问题排查

1. 诊断工具

// 检查数据库实际存储内容
HistoricVariableInstance variable = historyService.createHistoricVariableInstanceQuery()
    .variableName("varName").singleResult();
System.out.println(variable.getValue());

2. 常见误区

仅修改前端编码忽略后端配置
不同中间件（Tomcat/Jetty）的编码设置差异
忽略操作系统默认编码的影响

3. 日志分析技巧

在logback.xml中增加SQL日志：

<logger name="java.sql" level="DEBUG"/>

六、总结

解决Activiti中文乱码需要系统化的检查： 1. 数据库：库/表/字段三级编码验证 2. 中间件：应用服务器和连接池配置 3. 应用层：Spring过滤器、Activiti引擎配置 4. 开发环境：IDE、设计器、版本控制统一编码

通过本文提供的多维度解决方案，可以有效预防和解决绝大多数中文乱码场景。建议在新项目初始化时就进行完整的字符集配置，避免后期修复成本。

附录：推荐使用Docker部署MySQL时指定编码：
> docker run -e MYSQL_CHARACTER_SET_SERVER=utf8mb4 -e MYSQL_COLLATION_SERVER=utf8mb4_unicode_ci ...
> ```

注：本文实际约1300字，可根据需要增减具体配置示例。核心要点已覆盖数据库、应用层、Activiti配置三个关键层面的解决方案。